CDE/cde/doc/C/guides/man/man4/dtsdldtd.sgm

<!-- $XConsortium: dtsdldtd.sgm /main/12 1996/09/08 20:18:50 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<refentry id="CDEMX.MAN84.rsml.1" remap="">
<refmeta><refentrytitle>dtsdldtd</refentrytitle><manvolnum>other</manvolnum>
</refmeta>
<refnamediv><refname><literal>dtsdldtd</literal></refname><refpurpose>Semantic
Delivery Language (SDL) format and semantics</refpurpose></refnamediv>
<refsect1>
<title>DESCRIPTION</title>
<para>Semantic Delivery Language (SDL) is defined by a Standard Generalized
Markup Language (SGML) document type description (DTD). The language uses
generalized presentation-oriented markup and excludes typical SGML features
that may prevent performance-oriented, on-line delivery systems from using
the language.</para>
<refsect2>
<title>Dependencies</title>
<para>None.</para>
</refsect2>
<refsect2>
<title>Issues</title>
<para>None.</para>
</refsect2>
</refsect1>
<refsect1>
<title>TOP LEVEL ELEMENTS</title>
<para></para>
</refsect1>
<refsect1>
<title>SDLDOC</title>
<refsect2>
<title>Purpose</title>
<para>The top of the document hierarchy.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="1.96in">
<colspec align="left" colwidth="4.51in">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT sdldoc</literal></entry>
<entry align="left" valign="top"><literal>- - (vstruct, head*, snb?, virpage+)
></literal></entry></row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.39in">
<colspec align="left" colwidth="148*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="101*">
<colspec align="left" colwidth="114*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST</literal> sdldoc</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>pub-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>doc-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>timestmp</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>first-page</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>product</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>prodpn</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>prodver</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>license</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>author</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>sdldtd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srcdtd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The document element, <literal>sdldoc</literal>, is the top of the document
hierarchy. There are several attributes used in identifying the applicability
of this document. Version and language attributes list options available
for qualifying selected sections of the document.</para>
<para>The attributes of <literal>sdldoc</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="0.88in">
<colspec align="left" colwidth="0.99in">
<colspec align="left" colwidth="1.00in">
<colspec align="left" colwidth="3.19in">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>pub-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The public identifier is used to represent
a document. It is analogous to a part number.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>doc-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The document identifier is specific to this
version  (instance) of a document. It is analogous to a manufacturing part
number.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>timestmp</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The time stamp distinguishes documents that
 have not changed enough to warrant a new doc-id,  but might need some bookmark/annotation
 cleanup or repair.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>first-page</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">If specified, the <emphasis>first-page</emphasis>
attribute identifies the  virtual page to display upon first entering the
document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>product</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A description of the product this document
 describes.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>prodpn</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The part number of the product this document
 describes.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>prodver</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version level of the product this document
 describes.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>license</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Product license information. By default,
no  license restrictions are applied.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The default language of the document. This
 attribute may be overridden in later elements.  The <symbol role="Variable">language</symbol> attribute and the <symbol role="Variable">charset</symbol>
attribute  of elements are used to select the proper font for  display.</entry>
</row>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The default character set of the document.
This attribute may be overridden in later elements. The <symbol role="Variable">charset</symbol> attribute and the <symbol role="Variable">language</symbol>
attribute are used to select the proper font for display.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>author</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The source author or publisher of the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The default version of this document. This
attribute may be overridden in later elements.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>sdldtd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The version level of the SDL DTD to which
this document conforms. This attribute is specified as &lt;major>.&lt;minor>
version. For example, <literal>1.0</literal>. A change in the minor version
number implies a change that is backward compatible, albeit with potentially
reduced functionality in an older viewer. A change in the major version implies
an  incompatible change to the DTD.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>srcdtd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The name of the DTD to which the source document
conformed.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>VSTRUCT</title>
<refsect2>
<title>Purpose</title>
<para>The container for all generated elements.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.09in">
<colspec align="left" colwidth="176*">
<colspec align="left" colwidth="329*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT vstruct</literal></entry>
<entry align="left" valign="top"><literal>- - (loids, toss?, lophrases?, index?,
rel-docs?, rel-file?, notes?) ></literal></entry></row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="176*">
<colspec align="left" colwidth="61*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="136*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST vstruct</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>doc-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>vstruct</literal> element is a container for all generated
elements. Generated elements are items such as a list of identifiers in the
document, a table of semantics and styles, and an index. The contents of this
element are the normalized navigation information elements generated by the
conversion process. No actual document content should be encoded within these
elements.</para>
<para>The attributes of <literal>vstruct</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.75in">
<colspec align="left" colwidth="76*">
<colspec align="left" colwidth="82*">
<colspec align="left" colwidth="82*">
<colspec align="left" colwidth="238*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the version of the <literal>vstruct</literal> is the same as the version of
 the document (<literal>sdldoc</literal>).</entry></row>
<row>
<entry align="left" valign="top"><emphasis>doc-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The document identifier of the document to
 which this element belongs.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>VIRPAGE</title>
<refsect2>
<title>Purpose</title>
<para>The smallest directly addressable unit in a document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="2.12in">
<colspec align="left" colwidth="4.25in">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT virpage</literal></entry>
<entry align="left" valign="top"><literal>- - (head*, snb?, (block | form)*)
></literal></entry></row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.39in">
<colspec align="left" colwidth="175*">
<colspec align="left" colwidth="66*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="124*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST virpage</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">level</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>doc-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The virtual page ( <literal>virpage</literal>) element is the smallest,
directly addressable unit in a document. It corresponds to a topic. Ideally,
documents presented on-line (and perhaps even on paper) should be organized
into small topics that are complete unto themselves. This allows readers to
find and access the desired information.</para>
<para>A virtual page contains all information necessary to establish a formatting
context. Virtual pages may be displayed and understood when removed from
the context of the document as long as the table of semantics and styles
( <literal>toss</literal>) element is available for formatting information.
</para>
<para>A virtual page may have zero or more <literal>head</literal> elements
that provide title information and may also be used in display decoration,
such as a title bar. The first <literal>head</literal> of a virtual page is
intended to be displayed in a table of contents for the document.</para>
<para>Following the <literal>head</literal> elements is an optional system
notation block ( <literal>snb</literal>). The system notation block, which
provides access to objects external to the document, is covered later in this
document.</para>
<para>Finally, a virtual page may contain any combination of <literal>block</literal> or <literal>form</literal> elements, including none.</para>
<para>The attributes of <literal>virpage</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.19in">
<colspec align="left" colwidth="57*">
<colspec align="left" colwidth="78*">
<colspec align="left" colwidth="78*">
<colspec align="left" colwidth="300*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the virtual page. The <emphasis>id</emphasis> attribute  must be a valid SGML identifier and must be  unique
within the document. To display a virtual  page, hyperlink to this <emphasis>id</emphasis>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">level</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The hierarchical level of the information
contained in the element. The <symbol role="Variable">level</symbol> attribute
makes  explicit information that is implicit in typical  SGML conforming documents.
An SDL conforming document may be considered to have  been flattened to allow
direct access of inferior  topics. For example, if the source DTD specified
divisions such as <literal>chapter</literal>, <literal>d1</literal>, <literal>d2</literal>, these would all  appear in the SDL version of the document as
virtual pages but with levels of <literal>1</literal>, <literal>2</literal>
and <literal>3</literal>, respectively.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the version of the <literal>virpage</literal> is the same as the version of
 the document (<literal>sdldoc</literal>).</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The language in which this element is written.
This attribute may be overridden individually within the <literal>form</literal>
and <literal>block</literal> elements contained in the virtual page.</entry>
</row>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The default character set of the document.
This attribute may be overridden individually within  the <literal>form</literal>
and <literal>block</literal> elements contained in the virtual page.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>doc-id</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The document identifier of the document to
 which this element belongs.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD or  other source to SDL translator.
It may either  reflect the meaning of the markup in the original  document
or may reflect the actual generic identifier in the original document. The
source semantic identifier may be used to  assist in semantic searches of
the SDL conforming document by preserving the original intent of  the markup.
When the original markup was conforming to a domain specific DTD, the <emphasis>ssi</emphasis> may be  used to enable structured searches of the SDL  conforming
document by preserving the original  generic identifiers.</entry></row></tbody>
</tgroup></informaltable>
<para>The <symbol role="Variable">level</symbol> and <emphasis>ssi</emphasis>
attributes of the virtual page are used to look up formatting and semantic
information in the table of semantics and styles ( <literal>toss</literal>)
element covered later in this document.</para>
</refsect1>
<refsect1>
<title>SNB</title>
<refsect2>
<title>Purpose</title>
<para>The container for all references to objects external to the document.
</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.39in">
<colspec align="left" colwidth="138*">
<colspec align="left" colwidth="393*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT snb</literal></entry>
<entry align="left" valign="top"><literal>- - (head?, (graphic | text | audio
| video |animate | crossdoc | man-page | textfile | sys-cmd | callback | script
| switch)+) ></literal></entry></row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="5.39in">
<colspec align="left" colwidth="149*">
<colspec align="left" colwidth="72*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="153*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST snb</literal></entry>
<entry align="left" valign="top"><emphasis>version</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The system notation block ( <literal>snb</literal>) provides a container
for elements that access data that are not in SGML notation. The one exception
to this rule is the <literal>text</literal> element. The <literal>text</literal>
element is in the system notation block because it is intended for use as
a rich text alternative to other elements in the <literal>snb</literal> when
elements are tried in turn during the instantiation of a system notation reference
( <literal>snref</literal>) looking for an alternative that can be formatted
on the current system.</para>
<para>Data in the system notation block are not intended to be presented to
the reader in the order that they appear in the document. The structural
position of each <literal>snb</literal> element is established by a system
notation reference.</para>
<para>Collecting all elements that require system resources at the top of
the virtual page allows an application to marshal these resources before they
are referenced. This gives the application the ability to alter the presentation
of both the element and its reference based on the availability and performance
of the required system resources.</para>
<para>The optional <literal>head</literal> element may be used by an application
when presenting a list of required resources for a document.</para>
<para>The attribute of <literal>snb</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.27in">
<colspec align="left" colwidth="55*">
<colspec align="left" colwidth="69*">
<colspec align="left" colwidth="72*">
<colspec align="left" colwidth="324*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the version of the <literal>snb</literal> is the same as the version of the
document (<literal>sdldoc</literal>).</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>BLOCK</title>
<refsect2>
<title>Purpose</title>
<para>The basic unit of display style.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="152*">
<colspec align="left" colwidth="304*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT block</literal></entry>
<entry align="left" valign="top"><literal>- - (head*, (p | cp)*) ></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<colspec align="left" colwidth="151*">
<colspec align="left" colwidth="69*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="39*">
<colspec align="left" colwidth="114*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST block</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">level</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(table</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">length</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">app</symbol></entry>
<entry align="left" valign="top">(all</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">help</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">tutorial</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ref</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sys</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>timing</emphasis></entry>
<entry align="left" valign="top">(sync</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">async</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>Blocks are the basic unit of display style. All data within a block
are rendered in the style of the block that contains them. Blocks may contain
zero or more <literal>head</literal> elements followed by zero or more paragraphs
( <literal>p</literal>) or character paragraphs ( <literal>cp</literal>).
</para>
<para>Structurally, blocks contain a set of logically related paragraphs.
A block identifies a display chunk, not document hierarchy elements. Blocks
have an inherently flat structure; blocks do not nest. The presentational
effect of nested blocks can be achieved by using the <symbol role="Variable">level</symbol> attribute.</para>
<para>The structure of a document includes blocks that are part of the principal
view and, optionally, blocks that form an alternate view. The principle view
makes the assumption that primary blocks are presented in order as the sequential
content of the document. That is, when taken in order the primary blocks compose
the principle view of the document. For the purpose of this language, the
principle view is the same as the traditional, printed view.</para>
<para>An alternate block is asynchronous to the primary document order. Alternate
blocks may represent traditional, asynchronous elements such as a footnote
or a spread, or some additional documentation (a teacher's section of a combined
teacher/student manual, for example.) Alternate content blocks should only
be included in the primary content by reference.</para>
<para>The <symbol role="Variable">level</symbol>, <symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> attributes of a <literal>block</literal> can be used to look up formatting and semantic information in the
table of semantics and styles ( <literal>toss</literal>) element (covered
later in this document).</para>
<para>The attributes of <literal>block</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.49in">
<colspec align="left" colwidth="58*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="323*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the <literal>block</literal>.
The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and
must be unique  within the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">level</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The hierarchical level of the information
contained in the element. The <symbol role="Variable">level</symbol> attribute
makes  explicit information that is implicit in typical  SGML-conforming documents.
An SDL-conforming document may be considered to have  been flattened with
implicit <literal>block</literal> nesting  information stored in the
<symbol role="Variable">level</symbol> attribute.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the <symbol role="Variable">version</symbol> of the <literal>block</literal>
is the same as the <symbol role="Variable">version</symbol> of the  document
(<literal>sdldoc</literal>) unless that <symbol role="Variable">version</symbol>
has been  overridden by a <symbol role="Variable">version</symbol> attribute
in the virtual  page (<literal>virpage</literal>) or <literal>form</literal>
(covered later in this document) containing the <literal>block</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <symbol role="Variable">class</symbol>
of a <literal>block</literal> describes the general</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">purpose the <literal>block</literal> is filling.
The <symbol role="Variable">class</symbol> attribute is</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">used in conjunction with the <symbol role="Variable">level</symbol> and <emphasis>ssi</emphasis></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">attributes to perform a lookup in the table
of</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">semantics and styles (<literal>toss</literal>)
element. The result of</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">that lookup is formatting and semantic information
pertaining to the <literal>block</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The language in which this <literal>block</literal> was written.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The character set of this <literal>block</literal>. The <symbol role="Variable">language</symbol> and <symbol role="Variable">charset</symbol> attributes plus information retrieved from  the table of
semantics and styles (<literal>toss</literal>) element  are used to select
the font for the <literal>block</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">length</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">By default, the <symbol role="Variable">length</symbol> of a <literal>block</literal> is determined  dynamically as
a function of its content and rendering style. If a <symbol role="Variable">length</symbol> value is present, it  describes the length of the <literal>block</literal> in terms of current style lines.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">app</symbol></entry>
<entry align="left" valign="top">all</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <symbol role="Variable">app</symbol>
attribute is used for selective presentation of a <literal>block</literal>.
This attribute defaults to all.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">help</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">tutorial</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ref</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sys</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>timing</emphasis></entry>
<entry align="left" valign="top">sync</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <emphasis>timing</emphasis> attribute
defaults to sync.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">async</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">A <literal>block</literal>  with a <emphasis>timing</emphasis> attribute of async is only  displayed when referenced via
an IDREF (or  IDREFS). For example, an async <literal>block</literal> may
 be referenced by the <emphasis>cells</emphasis> attribute of <emphasis>frowvec</emphasis> to  repeat the block without reentering its data content.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of the markup. When the original
markup conforms to a domain-specific DTD, the <emphasis>ssi</emphasis> may
be  used to enable structured searches of the SDL-conforming document by preserving
the original  generic identifiers.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>FORM</title>
<refsect2>
<title>Purpose</title>
<para>A two dimensional array of <literal>block</literal> and/or <literal>form</literal> elements.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="5.28in">
<colspec align="left" colwidth="148*">
<colspec align="left" colwidth="291*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT form</literal></entry>
<entry align="left" valign="top"><literal>- - (head*, (fstyle, fdata) | (fdata,
fstyle)) ></literal></entry></row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<colspec align="left" colwidth="144*">
<colspec align="left" colwidth="64*">
<colspec align="left" colwidth="82*">
<colspec align="left" colwidth="39*">
<colspec align="left" colwidth="127*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST form</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">level</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(table</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">length</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">app</symbol></entry>
<entry align="left" valign="top">(all</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">help</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">tutorial</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ref</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sys</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>form</literal> element is a generalized representation
of a data element that is partially preformatted. The <literal>form</literal>
element is designed to be rendered in real time and automatically derived
from typical SGML table markup. Uses include tables, lists and labeled lists.
Generally, a <literal>form</literal> may be used to represent any information
that is layout sensitive or contains data to be presented in a two dimensional
matrix.</para>
<para>A <literal>form</literal> is made up of zero or more <literal>head</literal>
elements followed either by a form style ( <literal>fstyle</literal>) and
the form data ( <literal>fdata</literal>) or the form data followed by the
form style.</para>
<para>The attributes of <literal>form</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.21in">
<colspec align="left" colwidth="65*">
<colspec align="left" colwidth="71*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="297*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the <literal>form</literal>.
The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and
must be unique  within the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">level</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The hierarchical level of the information
contained in the element. The <symbol role="Variable">level</symbol> attribute
makes  explicit information that is implicit in typical  SGML-conforming documents.
An SDL-conforming document may be considered to have  been flattened with
implicit <literal>form</literal> nesting information stored in the
<symbol role="Variable">level</symbol> attribute.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the <symbol role="Variable">version</symbol> of the <literal>form</literal>
is the same as the <symbol role="Variable">version</symbol> of the  document
(<literal>sdldoc</literal>) unless that <symbol role="Variable">version</symbol>
has been  overridden by a <symbol role="Variable">version</symbol> attribute
in the virtual  page (<literal>virpage</literal>) containing the <literal>form</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <symbol role="Variable">class</symbol>
of a <literal>form</literal> describes the general</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">purpose the <literal>form</literal> is filling.
The <symbol role="Variable">class</symbol> attribute is used in conjunction
with the <symbol role="Variable">level</symbol> and</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis> attributes to perform
a lookup in</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">the table of semantics and styles ( <literal>toss</literal>)</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">element. The result of that lookup is formatting</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">and semantic information pertaining to the <literal>form</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The language in which this <literal>form</literal> was written.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The character set of this <literal>form</literal>.
The <symbol role="Variable">language</symbol> and <symbol role="Variable">charset</symbol> attributes plus information retrieved from  the table of
semantics and styles (<literal>toss</literal>) element  are used to select
the font for the <literal>form</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">length</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">By default, the <symbol role="Variable">length</symbol> of a <literal>form</literal> is determined  dynamically as
a function of its content and rendering style. If a <symbol role="Variable">length</symbol> value is present, it  describes the length of the <literal>form</literal> in terms of current style lines.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">app</symbol></entry>
<entry align="left" valign="top">all</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <symbol role="Variable">app</symbol>
attribute is used for selective</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">help</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">presentation of a <literal>form</literal>.
This attribute defaults</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">tutorial</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">to all.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ref</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sys</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document.</entry>
</row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>FSTYLE</title>
<refsect2>
<title>Purpose</title>
<para>Specify the style of a form.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="162*">
<colspec align="left" colwidth="294*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT fstyle</literal></entry>
<entry align="left" valign="top"><literal>- - (frowvec+) ></literal></entry>
</row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The form style (<literal>fstyle</literal>) element specifies the style
of the <literal>form</literal>. It is composed of one or more row reference
vectors (<literal>frowvec</literal>). The list of cell id references in the
reference row vectors establishes the relationship between the position and
data block for a cell.</para>
<para>The form style element and <literal>formstyle</literal> element in the
table of semantics and styles (<literal>toss</literal>) element (covered later
in this document) contain information regarding the presentational style of
the <literal>form</literal>. Cell-specific style and style attributes beyond
those provided in the reference vectors must be specified in the data blocks
that contain the cell data.</para>
<para>The attribute of <literal>fstyle</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="0.75in">
<colspec align="left" colwidth="1.10in">
<colspec align="left" colwidth="0.88in">
<colspec align="left" colwidth="3.28in">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>ncols</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The number of columns in the <literal>form</literal>. This  attribute should be a number greater than zero.  Unless
overridden by a column width (<emphasis>colw</emphasis>)  specification in
the <literal>toss</literal>, the available space is  divided evenly among
the columns. Unless overridden by a column justification (<emphasis>colj</emphasis>)
specification in the <literal>toss</literal>, the <literal>block</literal>
and/or <literal>form</literal> elements  in the <literal>form</literal> are
left justified in their cells.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>FROWVEC</title>
<refsect2>
<title>Purpose</title>
<para>Describes the style of a row and contains ID references to the contents
of the row.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="2.12in">
<colspec align="left" colwidth="4.25in">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT frowvec</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.39in">
<colspec align="left" colwidth="175*">
<colspec align="left" colwidth="66*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="124*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST frowvec</literal></entry>
<entry align="left" valign="top"><emphasis>hdr</emphasis></entry>
<entry align="left" valign="top">(YES|NO)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>cells</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The reference row vector ( <literal>frowvec</literal>) describes the
style of a row in a <literal>form</literal> and contains pointers (id references)
to the contents of the row. There must be a row vector per row in the <literal>form</literal>.</para>
<para>The <emphasis>hdr</emphasis> attribute designates the entire row as
a head row. Heads are significant because a display program might need to
manage the display of heads differently than it does the data matrix. This
is particularly true if the <literal>form</literal> must scroll, covers multiple
screens or is displayed as a graph.</para>
<para>The attributes of <literal>frowvec</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.00in">
<colspec align="left" colwidth="57*">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="277*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>hdr</emphasis></entry>
<entry align="left" valign="top">yes</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Indicates whether or not the associated row
is a head row.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">no</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>cells</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">A list of id references to the <literal>block</literal> or <literal>form</literal> elements in the <literal>fdata</literal> element that make up the cell  contents of this <literal>form</literal>.</entry></row></tbody></tgroup></informaltable>
<para>Within a <literal>form</literal> element, spanning of rows or columns
is done by repeating the appropriate id reference in the <emphasis>cells</emphasis>
attribute of the <literal>frowvec</literal>. If the data is to be repeated
in multiple unspanned cells, the <literal>block</literal> must be repeated
and assigned unique identifiers.</para>
<para>The length of a row is the length of the cells in that row; the width
is the cumulative width of each cell in that row. Row length may be determined
at or before runtime. Typically, the length of a row is the length of the
longest <literal>block</literal> or <literal>form</literal> in the row. There
are two exceptions to this rule: the blocks or forms in the row can have
an assigned length, or the id reference could be to an element that is not
in the data container. These exceptional cells are referred to as virtual
cells; virtual cells do not affect the length of the row.</para>
<para>Virtual cells may contain more data than can be displayed in the area
assigned. Examples include blocks with the length set that contain long paragraphs,
forms or figures. The actual display area of a virtual cell can be thought
of as a viewport onto the data of a cell. Alternatively, virtual cells can
use an information hiding technique such as an icon leading to a separate
window.</para>
<para>The id references in a reference row may specify elements that are not
in the data container of its <literal>form</literal>, even if the elements
are not physically close. To protect the performance of the <literal>form</literal> element, references to data outside the current <literal>form</literal> may also be handled as virtual cells. The display program may
take the liberty to replace any information referenced in a row vector that
does not belong to the current <literal>form</literal>'s data element with
a link or icon.</para>
</refsect1>
<refsect1>
<title>FDATA</title>
<refsect2>
<title>Purpose</title>
<para>A container for information belonging solely to a <literal>form</literal>
element.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="1.87in">
<colspec align="left" colwidth="4.48in">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT fdata</literal></entry>
<entry align="left" valign="top"><literal>- - ((block | form)*) ></literal></entry>
</row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>form</literal> data element ( <literal>fdata</literal>)
is a container for information that belongs to a <literal>form</literal>.
By default, without spanning and external references, <literal>form</literal>
data is typically maintained in row major matrix form. Assumptions about the
order of the <literal>block</literal> or <literal>form</literal> elements
in the data area must not be used for anything except performance because
the blocks are allowed to be represented in any order.</para>
<para>The <literal>fdata</literal> element has no attributes.</para>
</refsect1>
<refsect1>
<title>CONTAINER ELEMENTS</title>
<para></para>
</refsect1>
<refsect1>
<title>P</title>
<refsect2>
<title>Purpose</title>
<para>A paragraph.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.50in">
<colspec align="left" colwidth="126*">
<colspec align="left" colwidth="414*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT p</literal></entry>
<entry align="left" valign="top"><literal>- - (head*, (key | sphrase | rev
| if | spc | snref | anchor |  link | #PCDATA)+) ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<colspec align="left" colwidth="115*">
<colspec align="left" colwidth="61*">
<colspec align="left" colwidth="75*">
<colspec align="left" colwidth="38*">
<colspec align="left" colwidth="167*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST p</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">(literal</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>Paragraphs identify a formatting unit. Paragraphs collect information
that needs to be rendered contiguously within a region. Paragraphs inherit
style from their containing <literal>block</literal> although adjustments
can be made by using the <symbol role="Variable">class</symbol> and
<symbol role="Variable">level</symbol> attributes of the enclosing <literal>block</literal> plus the <emphasis>ssi</emphasis> attribute of the <literal>p</literal>
to effect a lookup in the table of semantics and styles ( <literal>toss</literal>)
element (covered later in this document).</para>
<para>Paragraphs may contain text, references and <literal>key</literal> phrases.
The <literal>key</literal> element (discussed later in this document) may
modify the style of a portion of a paragraph but the modification is always
restricted to the current paragraph.</para>
<para>The attributes of <literal>p</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.92in">
<colspec align="left" colwidth="68*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="76*">
<colspec align="left" colwidth="274*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the <literal>p</literal>.
The <emphasis>id</emphasis> attribute must be a  valid SGML identifier and
must be unique within  the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the <symbol role="Variable">version</symbol> of the <literal>p</literal> is
the same as the <symbol role="Variable">version</symbol> of the document ( <literal>sdldoc</literal>) unless that <symbol role="Variable">version</symbol> has
been  overridden by a <symbol role="Variable">version</symbol> attribute in
the virtual  page (<literal>virpage</literal>), <literal>form</literal> or <literal>block</literal> containing the <literal>p</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">literal</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Paragraph text may be either unformatted
or preformatted.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">By default, paragraph text is assumed dynamic
(unformatted) to be</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">and all white space (space, tab, newline,
etc.) may be replaced with a single space. The <symbol role="Variable">type</symbol>
attribute is used when the author needs to represent information
that is at least partially layout-sensitive. Newline characters are significant
in lined paragraphs and all whitespace is significant in literal paragraphs.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup was conforming to a domain specific DTD, the <emphasis>ssi</emphasis>
may be  used to enable structured searches of the SDL  conforming document
by preserving the original  generic identifiers.</entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>CP</title>
<refsect2>
<title>Purpose</title>
<para>A character paragraph.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="127*">
<colspec align="left" colwidth="329*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT cp</literal></entry>
<entry align="left" valign="top"><literal>- - (CDATA) ></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<colspec align="left" colwidth="131*">
<colspec align="left" colwidth="59*">
<colspec align="left" colwidth="70*">
<colspec align="left" colwidth="42*">
<colspec align="left" colwidth="154*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST cp</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">(literal</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>Character paragraphs are similar to paragraphs. The only difference
is that markup contained in the text of a character paragraph is ignored.
The only markup not ignored is the ``&lt;/'' character pair. If that pair
is to be included in the text, it must be preceded with an ampersand (&amp;).
</para>
<para>The attributes of <literal>cp</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.17in">
<colspec align="left" colwidth="55*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="87*">
<colspec align="left" colwidth="287*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the <literal>p</literal>.
The <emphasis>id</emphasis> attribute must be a  valid SGML identifier and
must be unique within  the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the <symbol role="Variable">version</symbol> of the <literal>p</literal> is
the same as the <symbol role="Variable">version</symbol> of the document ( <literal>sdldoc</literal>) unless that <symbol role="Variable">version</symbol> has
been  overridden by a <symbol role="Variable">version</symbol> attribute in
the virtual  page (<literal>virpage</literal>), <literal>form</literal> or <literal>block</literal> containing the <literal>p</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">literal</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Paragraph text may be either unformatted
or preformatted.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">By default, paragraph text is assumed  to
be dynamic (unformatted) and all white space</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">(space, tab, newline, etc.) may be replaced
with a single space. The <symbol role="Variable">type</symbol> attribute is
used when the author needs to represent information that is at least partially
layout-sensitive. Newline characters are significant in lined paragraphs and
all whitespace is significant in literal paragraphs.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup was conforming to a domain-specific DTD, the <emphasis>ssi</emphasis>
may be  used to enable structured searches of the SDL-conforming document
by preserving the original  generic identifiers.</entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>HEAD</title>
<refsect2>
<title>Purpose</title>
<para>Heading, label or caption.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.39in">
<colspec align="left" colwidth="150*">
<colspec align="left" colwidth="377*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT head</literal></entry>
<entry align="left" valign="top"><literal>- - ((key | sphrase | rev | if |
spc | snref | anchor | link | #PCDATA)*,  subhead*) ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<colspec align="left" colwidth="146*">
<colspec align="left" colwidth="57*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="39*">
<colspec align="left" colwidth="140*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST head</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(label</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">caption</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">annotation</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">phead</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefhead</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">(literal</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>abbrev</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>Heads are phrase-like elements that are associated with the entire section
that contains it. Heads may contain zero or more <literal>subhead</literal>
elements followed by zero or more paragraphs.</para>
<para>The <literal>head</literal> element may also be used as the caption
of a graphic (covered later in this document).</para>
<para>The user-defined head ( <literal>udefhead</literal>) value is for use
by the developer of a higher level DTD to SDL translator when an unexpected
use for a <literal>head</literal> is found.</para>
<para>The attributes of <literal>head</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.27in">
<colspec align="left" colwidth="61*">
<colspec align="left" colwidth="82*">
<colspec align="left" colwidth="72*">
<colspec align="left" colwidth="305*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the <literal>head</literal>.
The <emphasis>id</emphasis> attribute must be a  valid SGML identifier and
must be unique within  the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the <symbol role="Variable">version</symbol> of the <literal>head</literal>
is the same as the <symbol role="Variable">version</symbol> of the  document
(<literal>sdldoc</literal>) unless that <symbol role="Variable">version</symbol>
has been  overridden by a <symbol role="Variable">version</symbol> attribute
in the virtual  page (<literal>virpage</literal>), <literal>form</literal>
or <literal>block</literal> containing the  <literal>head</literal>.</entry>
</row>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">label</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <symbol role="Variable">class</symbol>
of a <literal>head</literal> describes the general purpose the <literal>head</literal> is filling.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The <symbol role="Variable">class</symbol>
attribute is used</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">caption</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in conjunction with the <symbol role="Variable">level</symbol> of the object</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">annotation</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">containing the <literal>head</literal> and <emphasis>ssi</emphasis> attributes</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">phead</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">to perform a  lookup in the table of semantics</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefhead</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">and styles (<literal>toss</literal>)  element.
The result of that lookup is formatting  and semantic information pertaining
to the <literal>head</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The language in which this <literal>head</literal> was written.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The character set of this <literal>head</literal>.
The <symbol role="Variable">language</symbol> and <symbol role="Variable">charset</symbol> attributes plus information retrieved from  the table of
semantics and styles (<literal>toss</literal>) element  are used to select
the font for the <literal>head</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">literal</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Head text may be either unformatted or preformatted.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">By default, paragraph text is assumed  to
be dynamic (unformatted)</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">and all white space (space, tab, newline,
etc.) may be replaced with a single space. The <symbol role="Variable">type</symbol>
attribute is used when the author needs to represent information
that is at least partially layout-sensitive. Newline characters are significant
in lined heads and all whitespace is significant in literal heads.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>abbrev</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">An abbreviation allows simple and/or short
text  to be associated with a <literal>head</literal> element. This text
may be used in situations where rich text is inappropriate or where the <literal>head</literal> is too long to use.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup conforms to a domain specific DTD, the <emphasis>ssi</emphasis> may
be  used to enable structured searches of the SDL-conforming document by preserving
the original generic identifiers.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SUBHEAD</title>
<refsect2>
<title>Purpose</title>
<para>Alternate or additional headings, labels or captions.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.49in">
<colspec align="left" colwidth="175*">
<colspec align="left" colwidth="360*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT subhead</literal></entry>
<entry align="left" valign="top"><literal>- - ((key | sphrase | rev |  if
| spc | snref | anchor | link | #PCDATA)*) ></literal></entry></row></tbody>
</tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.81in">
<colspec align="left" colwidth="179*">
<colspec align="left" colwidth="70*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="40*">
<colspec align="left" colwidth="110*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST subhead</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(label</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">caption</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">annotation</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">phead</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefhead</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">(literal</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>abbrev</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>Subheads are simply one or more phrase-like elements that further refine
the main head.</para>
<para>The attributes of <literal>subhead</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.10in">
<colspec align="left" colwidth="58*">
<colspec align="left" colwidth="77*">
<colspec align="left" colwidth="72*">
<colspec align="left" colwidth="299*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the <literal>subhead</literal>.
The <emphasis>id</emphasis> attribute must be a  valid SGML identifier and
must be unique within  the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">version</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The version of this element. By default,
the version of the <literal>subhead</literal> is the same as the <symbol role="Variable">version</symbol>
of  the document (<literal>sdldoc</literal>) unless that
<symbol role="Variable">version</symbol> has  been overridden by a
<symbol role="Variable">version</symbol> attribute in the virtual page
(<literal>virpage</literal>), <literal>form</literal>, <literal>block</literal>
or <literal>head</literal> containing
the <literal>subhead</literal>.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">label</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <symbol role="Variable">class</symbol>
of a <literal>subhead</literal> describes the general</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">purpose the <literal>subhead</literal> is
filling. The <symbol role="Variable">class</symbol> attribute is used in conjunction
with</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">caption</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">the <symbol role="Variable">level</symbol>
of the object containing the <literal>head</literal> to</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">annotation</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">which the <literal>subhead</literal> belongs
and <emphasis>ssi</emphasis></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">phead</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">attributes to perform a lookup in the table
of semantics and styles (<literal>toss</literal>) element.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefhead</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The result of that lookup is formatting and
 semantic information pertaining to the <literal>subhead</literal>.</entry>
</row>
<row>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The language in which this <literal>subhead</literal> was written.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The character set of this <literal>subhead</literal>. The <symbol role="Variable">language</symbol>  and <symbol role="Variable">charset</symbol> attributes plus information retrieved  from the table of
semantics and styles (<literal>toss</literal>) element are used to select
the <literal>subhead</literal> font.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">literal</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Subhead text may be either unformatted or
preformatted.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lined</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">By default, subhead text is assumed  to be
dynamic (unformatted)</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">and all white space (space, tab, newline,
etc.) may be replaced with a single space. The <symbol role="Variable">type</symbol>
attribute is used when the author needs to represent information
that is at least partially layout-sensitive. Newline characters are significant
in lined <literal>subheads</literal> and all whitespace is significant in
literal <literal>subheads</literal>.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>abbrev</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">An abbreviation allows simple and/or short
text  to be associated with a <literal>subhead</literal> element. This text
 may be used in situations where rich text is inappropriate or where the <literal>subhead</literal> is too long to use.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup conforms to a domain specific DTD, the <emphasis>ssi</emphasis> may
be  used to enable structured searches of the SDL-conforming document by preserving
the original  generic identifiers.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>ATOMIC LINK ELEMENTS</title>
<para></para>
</refsect1>
<refsect1>
<title>ANCHOR</title>
<refsect2>
<title>Purpose</title>
<para>To give an ID to a point in the document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="167*">
<colspec align="left" colwidth="289*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT anchor</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="166*">
<colspec align="left" colwidth="40*">
<colspec align="left" colwidth="43*">
<colspec align="left" colwidth="207*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST anchor</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>anchor</literal> element provides a mechanism for assigning
an ID to an arbitrary spot in the document. An <literal>anchor</literal> may
occur anywhere that running text is allowed. This includes as content of paragraphs
( <literal>p</literal>) and heads (<literal>head</literal> and <literal>subhead</literal>).</para>
<para>The attribute of <literal>anchor</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.10in">
<colspec align="left" colwidth="42*">
<colspec align="left" colwidth="50*">
<colspec align="left" colwidth="93*">
<colspec align="left" colwidth="321*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>anchor</literal>.
The <emphasis>id</emphasis> attribute must be a  valid SGML identifier and
must be unique within  the document.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>LINK</title>
<refsect2>
<title>Purpose</title>
<para>A hyperlink within or outside the current document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.39in">
<colspec align="left" colwidth="149*">
<colspec align="left" colwidth="378*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT link</literal></entry>
<entry align="left" valign="top"><literal>- - ((key | sphrase | rev |  if
| spc | snref | anchor | link | #PCDATA)+) ></literal></entry></row></tbody>
</tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.90in">
<colspec align="left" colwidth="150*">
<colspec align="left" colwidth="78*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="38*">
<colspec colwidth="149*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST link</literal></entry>
<entry align="left" valign="top"><emphasis>rid</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">button</symbol></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>linkinfo</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>descript</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">window</symbol></entry>
<entry align="left" valign="top">(current</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">new</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">popup</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>traversal</emphasis></entry>
<entry align="left" valign="top">(return</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">noreturn</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>A <literal>link</literal> element is the start point of a hyperlink
to another spot in the document or, via the system notation block ( <literal>snb</literal>), to another document or active hyperlink. The active hyperlinks
are <literal>sys-cmd</literal> and <literal>callback</literal>. These hyperlinks
(covered later in this document) are used to execute an operating system command
or to initiate a callback to the application respectively.</para>
<para>A <literal>link</literal> may surround any text in the document, including
text found in paragraphs or heads, with the only exception being that <literal>link</literal> elements may not contain other <literal>link</literal> elements.
</para>
<para>The attributes of <literal>link</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.16in">
<colspec align="left" colwidth="73*">
<colspec align="left" colwidth="69*">
<colspec align="left" colwidth="70*">
<colspec align="left" colwidth="296*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>rid</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The ID of the target of the hyperlink. The
ID specified must exist in the current document but may be to elements in
the system notation block (<literal>snb</literal>) of the current virtual
page (<literal>virpage</literal>) to allow reference to external objects or
actions.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">button</symbol></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A graphic that may be displayed as a trigger
for the hyperlink in lieu of or in addition to highlighting the hyperlink
text itself. The ID referenced by the <symbol role="Variable">button</symbol>
attribute must be the identifier of a graphic (covered later in this document)
in the system notation block (<literal>snb</literal>) of the current virtual
page (<literal>virpage</literal>). The graphic referenced must have a
<symbol role="Variable">class</symbol> attribute of button.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>linkinfo</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Information about the target of the <literal>link</literal>. This information may be displayed as part of a dialog with
the reader before traversing the <literal>link</literal> if such traversal
is in some way expensive in time.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>descript</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A general description of the action that
takes place when the hyperlink is activated.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">window</symbol></entry>
<entry align="left" valign="top">current</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">By default, hyperlinking to another location
in</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">new</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">this document or (via indirection) externally,</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">popup</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">is done by changing the view in the current
window or display area. Specifying <symbol role="Variable">new</symbol> for
the <symbol role="Variable">window</symbol> attribute causes a new window
or display area to be created for displaying hyperlink target. Specifying
<symbol role="Variable">popup</symbol> for this attribute causes the new window or
display area to be lighter weight, if possible. Often, popup windows are modal
and temporary.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>traversal</emphasis></entry>
<entry align="left" valign="top">return</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">By default, the current document and location</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">noreturn</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in the document are stored on a push down
stack to  allow backtracking of hyperlinks. If this attribute  is specified
as <emphasis>noreturn</emphasis>, the current location is  forgotten on execution
of the <literal>link</literal>.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SNREF</title>
<refsect2>
<title>Purpose</title>
<para>Reference to an element or alternates in the system notation block ( <literal>snb</literal>).</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="151*">
<colspec align="left" colwidth="305*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT snref</literal></entry>
<entry align="left" valign="top"><literal>- - (refitem+, alttext?) ></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="155*">
<colspec align="left" colwidth="37*">
<colspec align="left" colwidth="36*">
<colspec align="left" colwidth="228*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST snref</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>A system notation reference ( <literal>snref</literal>) is a reference
to an external object. The result of resolving that object is that it is
interpolated into the document at the point of the <literal>snref</literal>.
The <literal>snref</literal> element references <literal>graphic</literal>
and <literal>script</literal> elements, both of which are covered later in
this document.</para>
<para>An <literal>snref</literal> element consists of one or more <literal>refitem</literal> elements followed by optional alternate text. Each <literal>refitem</literal> is tried in turn in the order specified until one can be
successfully formatted and displayed. If none of the system notations can
be successfully formatted and displayed, the alternate text, <literal>alttext,</literal> which is very simple character data, is displayed instead.</para>
<para>The attribute of <literal>snref</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.07in">
<colspec align="left" colwidth="38*">
<colspec align="left" colwidth="42*">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="340*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the <literal>snref</literal>.
The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and
must be unique  within the document.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>REFITEM</title>
<refsect2>
<title>Purpose</title>
<para>A reference to an element in a system notation block.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="169*">
<colspec align="left" colwidth="287*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT refitem</literal></entry>
<entry align="left" valign="top"><literal>- - (head*) ></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.23in">
<colspec align="left" colwidth="176*">
<colspec align="left" colwidth="62*">
<colspec align="left" colwidth="81*">
<colspec align="left" colwidth="48*">
<colspec align="left" colwidth="147*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST refitem</literal></entry>
<entry align="left" valign="top"><emphasis>rid</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(figure</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in-line</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">button</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">icon</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefgraph</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">button</symbol></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>A reference item ( <literal>refitem</literal>) is a single reference
to an element in the system notation block ( <literal>snb</literal>) of the
current virtual page ( <literal>virpage</literal>).</para>
<para>An <literal>snref</literal> consists of one or more <literal>refitem</literal> elements allowing alternate choices for the item to be displayed.
The <literal>refitem</literal> elements are tried in turn in the order listed
until one can be successfully formatted and displayed. A <literal>refitem</literal> can refer to a text element in the <literal>snb</literal> to allow
a text alternative for the referenced item.</para>
<para>A <literal>refitem</literal> has zero or more <literal>head</literal>
elements, which may serve, for example, as the caption of a <literal>graphic</literal>.</para>
<para>The attributes of <literal>refitem</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.28in">
<colspec align="left" colwidth="52*">
<colspec align="left" colwidth="79*">
<colspec align="left" colwidth="71*">
<colspec align="left" colwidth="316*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>rid</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the item being referenced
in the  system notation block of the current virtual page.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">figure</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The <symbol role="Variable">class</symbol>
of a <literal>refitem</literal> describes the general purpose</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in-line</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">the <literal>refitem</literal> is filling.
The <symbol role="Variable">class</symbol> attribute is</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">button</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">used in conjunction with the <symbol role="Variable">level</symbol> of the enclosing</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">icon</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><literal>block</literal>, <literal>form</literal>
or <literal>virpage</literal> and <emphasis>ssi</emphasis> attributes to</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefgraph</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">perform a lookup in the table of semantics</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">and styles (<literal>toss</literal>) element.
The result of that</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">lookup is formatting and semantic information</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">pertaining to the <literal>refitem</literal>.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">button</symbol></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">An optional reference to a <literal>graphic</literal> of <symbol role="Variable">class</symbol> button in the <literal>snb</literal> of the current <literal>virpage</literal>. This <symbol role="Variable">button</symbol> may be used to request <literal>refitem</literal> display
on systems where display of the item is  slow or expensive in some other way.
That is, the <symbol role="Variable">button</symbol> is displayed and the <literal>refitem</literal> is only displayed when the <symbol role="Variable">button</symbol>
is activated.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning of the markup in the original document or it may
 reflect the actual generic identifier in the original document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup conforms to a domain specific DTD, the <emphasis>ssi</emphasis> may
be  used to enable structured searches of the SDL-conforming document by preserving
the original  generic identifiers.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>ALTTEXT</title>
<refsect2>
<title>Purpose</title>
<para>Simple text alternative for <literal>snref</literal>.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="171*">
<colspec align="left" colwidth="285*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT alttext</literal></entry>
<entry align="left" valign="top"><literal>- - CDATA ></literal></entry></row>
</tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>alttext</literal> element is a place to put simple text
for use if all alternatives, including text replacements, from the list of <literal>refitem</literal> elements in an <literal>snref</literal> fail to format.
</para>
<para>The <literal>alttext</literal> element has no attributes.</para>
</refsect1>
<refsect1>
<title>ATOMIC TEXT ELEMENTS</title>
<para></para>
</refsect1>
<refsect1>
<title>REV</title>
<refsect2>
<title>Purpose</title>
<para>Add change bars to displayed text.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.37in">
<colspec align="left" colwidth="138*">
<colspec align="left" colwidth="387*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT rev</literal></entry>
<entry align="left" valign="top"><literal>- - ((key | sphrase | if |  spc
| snref | anchor | link | #PCDATA)*) ></literal></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>Surrounding data with a <literal>rev</literal> element signals to the
formatter that the surrounded data should be marked somehow as having undergone
change. Typically, this mark is change bars on the side of the data. An empty <literal>rev</literal> element implies some text has been deleted.</para>
<para>The <literal>rev</literal> element has no attributes.</para>
</refsect1>
<refsect1>
<title>KEY</title>
<refsect2>
<title>Purpose</title>
<para>Effect a change in font.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informalexample remap="indent">
<programlisting>&lt;!ELEMENT key  - - ((key | sphrase | rev | if | spc | anchor | snref | #PCDATA)+) >
</programlisting>
</informalexample>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.92in">
<colspec align="left" colwidth="139*">
<colspec align="left" colwidth="60*">
<colspec align="left" colwidth="89*">
<colspec align="left" colwidth="55*">
<colspec align="left" colwidth="149*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST key</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(acro</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">book</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">emph</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">jargon</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">l10n</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">name</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">quote</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">product</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">termdef</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">term</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-in</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-out</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-cont</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">pub-lit</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefkey</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>Key phrases are data that are key to understanding the paragraph in
which they exist; that is, they have a special significance. The <literal>key</literal> element is used to call readers' attention to a particular phrase.
The <literal>key</literal> element exists only within the context of a paragraph
( <literal>p</literal>); it is document sub-structure.</para>
<para>The semantics of the <literal>key</literal> element have value to both
rendering and navigation. When rendered, the phrase is highlighted, typically
using a different font style or attribute. In navigation, <literal>key</literal>
data can be used as fields in semantic searches or as variables in a relevance-ranking
algorithm.</para>
<para>There are an infinite variety of key phrases possible in source documents.
To assure that the delivery system can fully use the semantics of <literal>key</literal> data, this delivery format forces the semantic to be normalized.
Each phrase is required to have a <symbol role="Variable">class</symbol> attribute
as well as an optional source semantic identifier ( <emphasis>ssi</emphasis>).
</para>
<para>The intended uses for the possible key classes are:</para>
<variablelist>
<varlistentry><term>acro</term>
<listitem>
<para>An acronym.</para>
</listitem>
</varlistentry>
<varlistentry><term>book</term>
<listitem>
<para>The proper title of a document.</para>
</listitem>
</varlistentry>
<varlistentry><term>emph</term>
<listitem>
<para>An emphasized phrase.</para>
</listitem>
</varlistentry>
<varlistentry><term>jargon</term>
<listitem>
<para>A phrase with application unique significance; its definition is commonly
understood by convention by the practitioner of the application field.</para>
</listitem>
</varlistentry>
<varlistentry><term>l10n</term>
<listitem>
<para>A phrase that must be specially treated during localization.</para>
</listitem>
</varlistentry>
<varlistentry><term>name</term>
<listitem>
<para>A proper name.</para>
</listitem>
</varlistentry>
<varlistentry><term>quote</term>
<listitem>
<para>A direct quote.</para>
</listitem>
</varlistentry>
<varlistentry><term>product</term>
<listitem>
<para>A proper product name.</para>
</listitem>
</varlistentry>
<varlistentry><term>pub-lit</term>
<listitem>
<para>A literal phrase added by the publisher.</para>
</listitem>
</varlistentry>
<varlistentry><term>termdef</term>
<listitem>
<para>A phrase defined within the current paragraph.</para>
</listitem>
</varlistentry>
<varlistentry><term>term</term>
<listitem>
<para>A phrase defined elsewhere.</para>
</listitem>
</varlistentry>
<varlistentry><term>mach-in</term>
<listitem>
<para>A machine input phrase.</para>
</listitem>
</varlistentry>
<varlistentry><term>mach-out</term>
<listitem>
<para>A machine output phrase.</para>
</listitem>
</varlistentry>
<varlistentry><term>mach-cont</term>
<listitem>
<para>A machine control or keyboard key name.</para>
</listitem>
</varlistentry>
<varlistentry><term>udefkey</term>
<listitem>
<para>A user-defined key; this may be used by the author of a higher level
DTD to SDL translator for unforeseen key phrases.</para>
</listitem>
</varlistentry>
</variablelist>
<para>The attributes of <literal>key</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.03in">
<colspec align="left" colwidth="62*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="277*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The character set of this <literal>key</literal>.
The <symbol role="Variable">language</symbol> of the  enclosing paragraph
(<literal>p</literal>) and <symbol role="Variable">charset</symbol> attributes
 plus information retrieved from the table of  semantics and styles ( <literal>toss</literal>) element are used to  select the font for the <literal>key</literal> .</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">acro</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">See above.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">book</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">emph</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">jargon</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">l10n</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">name</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">quote</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">product</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">pub-lit</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">termdef</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">term</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-in</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-out</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-cont</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefkey</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup conforms to a domain-specific DTD, the <emphasis>ssi</emphasis> may
be  used to enable structured searches of the SDL-conforming document by preserving
the original generic identifiers.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SPHRASE</title>
<refsect2>
<title>Purpose</title>
<para>A super or sub-scripted phrase</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="173*">
<colspec align="left" colwidth="283*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT sphrase</literal></entry>
<entry align="left" valign="top"><literal>- - CDATA ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<colspec align="left" colwidth="170*">
<colspec align="left" colwidth="46*">
<colspec align="left" colwidth="63*">
<colspec align="left" colwidth="46*">
<colspec align="left" colwidth="131*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST sphrase</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(super</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sub</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The stylized phrase (<literal>sphrase</literal>) contains stylized text.
The phrases are only presentationally significant. Two types are supported,
sub and super.</para>
<para>The attributes of <literal>sphrase</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.23in">
<colspec align="left" colwidth="60*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="295*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">super</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">Indicates whether the <literal>sphrase</literal>
should be set</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sub</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in superscript or subscript.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier  assists in semantic searches of the SDL-conforming document
by preserving the original intent of  the markup. When the original markup
conforms to a domain-specific DTD, the <emphasis>ssi</emphasis> may be  used
to enable structured searches of the SDL-conforming document by preserving
the original  generic identifiers.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SPC</title>
<refsect2>
<title>Purpose</title>
<para>A special character.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="137*">
<colspec align="left" colwidth="319*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT spc</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="135*">
<colspec align="left" colwidth="50*">
<colspec align="left" colwidth="79*">
<colspec align="left" colwidth="192*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST spc</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">name</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>spc</literal> element allows special characters, that is,
those not in the current font, to be included in text. This is often achieved
in DTDs by the use of character entities. SDL avoids runtime evaluation of
entities because entities are global to a document and, for performance reasons,
SDL applications often do not wish to process all global information just
to display a single topic.</para>
<para>The attribute of <literal>spc</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.14in">
<colspec align="left" colwidth="57*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="81*">
<colspec align="left" colwidth="294*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">name</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The name attribute must be one of the special
 character names, for example, ``[bull  ]'' (bullet), defined  in the public
character entities such as ISOpub,  ``ISO 8879:1986//ENTITIES Publishing//EN.''
These entities are defined in sections D.4.2.1  through D.4.5.6 of The SGML
Handbook (Goldfarb).</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>CONDITIONAL TEXT ELEMENTS</title>
<para></para>
</refsect1>
<refsect1>
<title>IF</title>
<refsect2>
<title>Purpose</title>
<para>Conditional inclusion of text or data.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="125*">
<colspec align="left" colwidth="331*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT if</literal></entry>
<entry align="left" valign="top"><literal>- - (cond, then, else?) ></literal></entry>
</row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>if</literal> element allows conditional inclusion of other
text and data elements.</para>
<para>The <literal>if</literal> element consists of a condition ( <literal>cond</literal>) followed by a <literal>then</literal> clause and an optional <literal>else</literal> clause. Based on the result of the condition, either the <literal>then</literal> clause or the <literal>else</literal> clause is included in
the document. If the condition is false and no <literal>else</literal> clause
exists, the <literal>if</literal> element is considered to be empty.</para>
<para>The <literal>if</literal> element has no attributes.</para>
</refsect1>
<refsect1>
<title>COND</title>
<refsect2>
<title>Purpose</title>
<para>Boolean condition for the <literal>if</literal> element.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="146*">
<colspec align="left" colwidth="310*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT cond</literal></entry>
<entry align="left" valign="top"><literal>- - CDATA ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.84in">
<colspec align="left" colwidth="148*">
<colspec align="left" colwidth="58*">
<colspec align="left" colwidth="104*">
<colspec align="left" colwidth="36*">
<colspec align="left" colwidth="135*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST cond</literal></entry>
<entry align="left" valign="top"><emphasis>interp</emphasis></entry>
<entry align="left" valign="top">NOTATION</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">(tcl</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sh</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ksh</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">csh</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>cond</literal> element contains a script to be run by the
interpreter specified in the <emphasis>interp</emphasis> attribute. The CDATA
content of <literal>cond</literal> is passed to the <emphasis>interp</emphasis>.
The return value from the interpreter should be numeric.</para>
<para>The attribute of <literal>cond</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.11in">
<colspec align="left" colwidth="63*">
<colspec align="left" colwidth="103*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="264*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>interp</emphasis></entry>
<entry align="left" valign="top">NOTATION -</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The interpreter to which to pass the CDATA
content</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">tcl</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">of the <literal>cond</literal> element. It
is expected that the interpreter</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">returns a numeric string value. One of the
listed</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ksh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">interpreters is often embedded  in the application</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">csh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">and does not require another  process to
execute. If the specified interpreter does not exist, or  returns a non-numeric
value, the default return  value is zero.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>THEN</title>
<refsect2>
<title>Purpose</title>
<para>Included text when the condition ( <literal>cond</literal>) of the <literal>if</literal> element is a non-zero string.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.39in">
<colspec align="left" colwidth="1.76in">
<colspec align="left" colwidth="4.59in">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT then</literal></entry>
<entry align="left" valign="top"><literal>- - (key | sphrase | rev | if |
 spc | snref | anchor | link | #PCDATA)*) ></literal></entry></row></tbody>
</tgroup></informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>then</literal> element contains text and data to be included
if the return value of the interpreter in the <literal>cond</literal> element
is a non-zero string. The <literal>then</literal> element may contain a nested <literal>if</literal> element as well as any other text or data acceptable in a paragraph
( <literal>p</literal>).</para>
<para>The <literal>then</literal> element has no attributes.</para>
</refsect1>
<refsect1>
<title>ELSE</title>
<refsect2>
<title>Purpose</title>
<para>Included text when the condition ( <literal>cond</literal>) of the <literal>if</literal> element is a string evaluating to zero.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informalexample remap="indent">
<programlisting>&lt;!ELEMENT else - - (key | sphrase | rev | if | spc | snref | anchor | link | #PCDATA)*) >
</programlisting>
</informalexample>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>else</literal> element contains text and data to be included
if the return value of the interpreter in the <literal>cond</literal> element
is a string evaluating to zero. The <literal>else</literal> element may contain
a nested <literal>if</literal> element as well as any other text or data
acceptable in a paragraph ( <literal>p</literal>).</para>
<para>The <literal>else</literal> element has no attributes.</para>
</refsect1>
<refsect1>
<title>NOTATION ELEMENTS</title>
<para></para>
</refsect1>
<refsect1>
<title>GRAPHIC</title>
<refsect2>
<title>Purpose</title>
<para>Attachment to a graphic image external to the current document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="171*">
<colspec align="left" colwidth="285*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT graphic</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="171*">
<colspec align="left" colwidth="66*">
<colspec align="left" colwidth="88*">
<colspec align="left" colwidth="131*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST graphic</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>graphic</literal> element allows incorporation of graphic
images into an SDL-conforming document. Only one graphic type element is declared;
the <symbol role="Variable">class</symbol> attribute is used to distinguish
between figure, in-line or button. A graphic image is incorporated by putting
an <literal>snref</literal> element in the document at the point of inclusion.
The <emphasis>rid</emphasis> attribute of the <literal>snref</literal> should
refer to the <literal>graphic</literal> element describing the storage location
and format of the image.</para>
<para>The attributes of <literal>graphic</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.04in">
<colspec align="left" colwidth="60*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="281*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>graphic</literal>.
The <emphasis>id</emphasis> attribute  must be a valid SGML identifier and
must be  unique within the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The format in which the graphic is stored.
Example values for the <symbol role="Variable">format</symbol> attribute are:
tiff, xpm, xbm and xwd.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A reference to a <literal>script</literal>
element (discussed later)  in the system notation block of the current virtual
 page. The script in the <literal>script</literal> element provides a  mechanism
for performing any setup necessary to  display the graphic image.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the graphic image.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>TEXT</title>
<refsect2>
<title>Purpose</title>
<para>Alternate rich text for <literal>snref</literal>.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="143*">
<colspec align="left" colwidth="313*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT text</literal></entry>
<entry align="left" valign="top"><literal>- - ((p | cp)*) ></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="145*">
<colspec align="left" colwidth="64*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="173*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST text</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>text</literal> element allows for rich text alternatives
to other elements in the system notation block being referenced by <literal>refitem</literal> elements in <literal>snref</literal>. A <literal>text</literal>
element contains zero or more paragraphs ( <literal>p</literal>) or character
paragraphs ( <literal>cp</literal>).</para>
<para>The attributes of <literal>text</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.13in">
<colspec align="left" colwidth="70*">
<colspec align="left" colwidth="75*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="275*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>text</literal>.
The <emphasis>id</emphasis> attribute must be  a valid SGML identifier and
must be unique  within the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">language</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The language in which this <literal>text</literal> was written.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">charset</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The character set of this text. The
<symbol role="Variable">language</symbol> and  <symbol role="Variable">charset</symbol>
attributes plus information retrieved from  the table of semantics and styles
(<literal>toss</literal>) element  are used to select the <literal>text</literal>
font.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>AUDIO</title>
<refsect2>
<title>Purpose</title>
<para>Attachment to an audio snippet external to the current document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="156*">
<colspec align="left" colwidth="300*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT audio</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="155*">
<colspec align="left" colwidth="70*">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="151*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST audio</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>audio</literal> element allows an audio snippet to be incorporated
into an SDL-conforming document. An audio snippet is incorporated by putting
an <literal>snref</literal> element in the document at the point of inclusion.
The <emphasis>rid</emphasis> attribute of the <literal>snref</literal> should
refer to the <literal>audio</literal> element describing the storage location
and format of the audio snippet.</para>
<para>The attributes of <literal>audio</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.14in">
<colspec align="left" colwidth="69*">
<colspec align="left" colwidth="71*">
<colspec align="left" colwidth="81*">
<colspec align="left" colwidth="285*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the audio. The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and must be unique
 within the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The format in which the audio snippet is
stored.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A reference to a <literal>script</literal>
element (covered later in this document)  in the system notation block of
the current virtual  page. The script in the <literal>script</literal> element
provides a  mechanism for performing any setup necessary to  present the audio
snippet.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the audio snippet.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>VIDEO</title>
<refsect2>
<title>Purpose</title>
<para>Attachment to a video clip external to the current document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="151*">
<colspec align="left" colwidth="305*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT video</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="155*">
<colspec align="left" colwidth="67*">
<colspec align="left" colwidth="68*">
<colspec align="left" colwidth="166*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST video</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>video</literal> element allows a video clip to be incorporated
into an SDL-conforming document. A video clip is incorporated by putting
an <literal>snref</literal> element in the document at the point of inclusion.
The <emphasis>rid</emphasis> attribute of the <literal>snref</literal> should
refer to the <literal>video</literal> element describing the storage location
and format of the video clip.</para>
<para>The attributes of <literal>video</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.21in">
<colspec align="left" colwidth="71*">
<colspec align="left" colwidth="75*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="283*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>video</literal>.
The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and
must be unique  within the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The format in which the video clip is stored.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A reference to a <literal>script</literal>
element (covered later in this document)  in the system notation block of
the current virtual  page. The script in the <literal>script</literal> element
provides a  mechanism for performing any setup necessary to  present the video
clip.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the video clip.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>ANIMATE</title>
<refsect2>
<title>Purpose</title>
<para>Attachment to an animation sequence external to the current document.
</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="170*">
<colspec align="left" colwidth="286*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT animate</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="169*">
<colspec align="left" colwidth="67*">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="140*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST animate</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>animate</literal> element allows an animation sequence
to be incorporated into an SDL-conforming document. An animation sequence
is incorporated by putting an <literal>snref</literal> element in the document
at the point of inclusion. The <emphasis>rid</emphasis> attribute of the <literal>snref</literal> should refer to the <literal>animate</literal> element describing
the storage location and format of the animation sequence.</para>
<para>The attributes of <literal>animate</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.14in">
<colspec align="left" colwidth="62*">
<colspec align="left" colwidth="73*">
<colspec align="left" colwidth="77*">
<colspec align="left" colwidth="294*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>animate</literal>.
The <emphasis>id</emphasis> attribute  must be a valid SGML identifier and
must be  unique within the document.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">format</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The format in which the animation sequence
is  stored.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>method</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A reference to a <literal>script</literal>
element (covered later in this document)  in the system notation block of
the current virtual  page. The script in the <literal>script</literal> element
provides a  mechanism for performing any setup necessary to  present the animation
sequence.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the animation
sequence.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SCRIPT</title>
<refsect2>
<title>Purpose</title>
<para>Data collection and/or generation of dynamic text.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="165*">
<colspec align="left" colwidth="291*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT script</literal></entry>
<entry align="left" valign="top"><literal>- - CDATA ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="5.98in">
<colspec align="left" colwidth="165*">
<colspec align="left" colwidth="57*">
<colspec align="left" colwidth="101*">
<colspec align="left" colwidth="45*">
<colspec align="left" colwidth="125*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST script</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>interp</emphasis></entry>
<entry align="left" valign="top">NOTATION</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">(tcl</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sh</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ksh</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">csh</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>script</literal> element is the mechanism within SDL for
collecting usage data or generating dynamic (on-the-fly) text. When referenced
via an <literal>snref</literal>, the CDATA content of the <literal>script</literal> element is passed to the designated interpreter. If the return
value from the interpreter is non- <symbol role="Define">NULL</symbol>, that
value is interpolated into the document at the point of the <literal>snref</literal>. If the designated interpreter is embedded in the application,
global variables may be used to collect usage data; otherwise, some mechanism,
such as temporary files, may be used.</para>
<para>The attributes of <literal>script</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.69in">
<colspec align="left" colwidth="57*">
<colspec align="left" colwidth="114*">
<colspec align="left" colwidth="87*">
<colspec align="left" colwidth="294*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>script</literal>.
The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and
must be unique  within the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>interp</emphasis></entry>
<entry align="left" valign="top">NOTATION -</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The interpreter to which to pass the CDATA</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">tcl</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">content of the <literal>script</literal>
element. One of the</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">listed interpreters is often embedded in
the</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ksh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">application and does not require another</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">csh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">process to execute. If the specified interpreter
does not exist, the default return value is <symbol role="Define">NULL</symbol>.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>CROSSDOC</title>
<refsect2>
<title>Purpose</title>
<para>Indirect element for following a hyperlink outside the current document.
</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="179*">
<colspec align="left" colwidth="277*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT crossdoc</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="188*">
<colspec align="left" colwidth="50*">
<colspec align="left" colwidth="71*">
<colspec align="left" colwidth="147*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST crossdoc</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>crossdoc</literal> element is the mechanism within SDL
for effecting a hyperlink to an external document. To create an external,
cross-document hyperlink, a <literal>link</literal> to the <literal>crossdoc</literal> is placed in the text. The <literal>crossdoc</literal> element
contains the necessary information to find the desired document and <emphasis>id</emphasis> within that document.</para>
<para>The attributes of <literal>crossdoc</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.05in">
<colspec align="left" colwidth="38*">
<colspec align="left" colwidth="71*">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="310*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>crossdoc</literal>.
The <emphasis>id</emphasis> attribute  must be a valid SGML identifier and
must be  unique within the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the external document
 and <emphasis>id</emphasis>.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>MAN PAGE</title>
<refsect2>
<title>Purpose</title>
<para>Indirect element for following a hyperlink to a reference manual page.
</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="183*">
<colspec align="left" colwidth="273*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT man-page</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT crossdoc</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="189*">
<colspec align="left" colwidth="49*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="144*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST man-page</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>man-page</literal> element is the mechanism within SDL
for effecting a hyperlink to (display of) a reference manual page such, as
a Unix man page. To create a man page hyperlink, a <literal>link</literal>
to the <literal>man-page</literal> is placed in the text. The <literal>man-page</literal> element contains the necessary information to find and display
the desired manual page.</para>
<para>The attributes of <literal>man-page</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.20in">
<colspec align="left" colwidth="45*">
<colspec align="left" colwidth="76*">
<colspec align="left" colwidth="81*">
<colspec align="left" colwidth="309*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The <literal>man-page</literal> identifier.
The <emphasis>id</emphasis> attribute  must be a valid SGML identifier and
must be  unique within the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the reference
manual  page.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>TEXTFILE</title>
<refsect2>
<title>Purpose</title>
<para>Indirect element for following a hyperlink to a text file.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="182*">
<colspec align="left" colwidth="274*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT textfile</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="182*">
<colspec align="left" colwidth="43*">
<colspec align="left" colwidth="76*">
<colspec align="left" colwidth="155*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST textfile</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>textfile</literal> element is the mechanism within SDL
for effecting a hyperlink to (display of) a text file. To create a text file
hyperlink, a <literal>link</literal> to the <literal>textfile</literal> is
placed in the text. The textfile element contains the necessary information
to find the desired file.</para>
<para>The attributes of <literal>textfile</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.14in">
<colspec align="left" colwidth="44*">
<colspec align="left" colwidth="68*">
<colspec align="left" colwidth="77*">
<colspec align="left" colwidth="317*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>textfile</literal>.
The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and
must be unique  within the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the text file.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SYS-CMD</title>
<refsect2>
<title>Purpose</title>
<para>Indirect element for following a hyperlink to a system command.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="170*">
<colspec align="left" colwidth="286*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT sys-cmd</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="171*">
<colspec align="left" colwidth="46*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="165*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST sys-cmd</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>sys-cmd</literal> element is the mechanism within SDL for
effecting a hyperlink to (execution of) a system command. To create a system
command hyperlink, a <literal>link</literal> to the <literal>sys-cmd</literal>
is placed in the text. The <literal>sys-cmd</literal> element contains the
necessary information to find and execute the system command.</para>
<para>The attributes of <literal>sys-cmd</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.03in">
<colspec align="left" colwidth="40*">
<colspec align="left" colwidth="65*">
<colspec align="left" colwidth="72*">
<colspec align="left" colwidth="320*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>sys-cmd</literal>.
The <emphasis>id</emphasis> attribute  must be a valid SGML identifier and
must be  unique within the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier for the system command.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>CALLBACK</title>
<refsect2>
<title>Purpose</title>
<para>Indirect element for following a hyperlink into the application.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="183*">
<colspec align="left" colwidth="273*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT callback</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="186*">
<colspec align="left" colwidth="45*">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="145*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST callback</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>callback</literal> element is the mechanism within SDL
for effecting a hyperlink into the enclosing application. To create a application
callback hyperlink, a <literal>link</literal> to the <literal>callback</literal>
is placed in the text. The <literal>callback</literal> element contains the
necessary information to inform the application of the desired action.</para>
<para>The attributes of <literal>callback</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.05in">
<colspec align="left" colwidth="43*">
<colspec align="left" colwidth="69*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="303*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>callback</literal>.
The <emphasis>id</emphasis> attribute  must be a valid SGML identifier and
must be  unique within the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xid</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">An external identifier and user data for
the application callback.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SWITCH</title>
<refsect2>
<title>Purpose</title>
<para>Conditional hyperlink.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="165*">
<colspec align="left" colwidth="291*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT switch</literal></entry>
<entry align="left" valign="top"><literal>- - CDATA ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.28in">
<colspec align="left" colwidth="163*">
<colspec align="left" colwidth="82*">
<colspec align="left" colwidth="97*">
<colspec align="left" colwidth="32*">
<colspec colwidth="144*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST switch</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>interp</emphasis></entry>
<entry align="left" valign="top">NOTATION</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">(tcl</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sh</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ksh</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">csh</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>branches</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>switch</literal> element is part of the system notation
block, <literal>snb</literal>, and is always instantiated via a reference
by a <literal>link</literal> element. When activated by the hyperlink, the
interpreter ( <emphasis>interp</emphasis>) is called passing it the CDATA
content of the switch and the interpreter returns a non-negative number. The
return value of the interpreter is used to index into the list of <emphasis>branches</emphasis> and the hyperlink is continued to that ID. A return value
that is non-numeric, less than zero or greater than the number minus one of
the <emphasis>id</emphasis>s in the <emphasis>branches</emphasis> attribute,
will cause the hyperlink to continue to the first <emphasis>branch</emphasis>
in the list.</para>
<para>The attributes of <literal>switch</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.31in">
<colspec align="left" colwidth="73*">
<colspec align="left" colwidth="106*">
<colspec align="left" colwidth="79*">
<colspec align="left" colwidth="262*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The identifier of the <literal>switch</literal>.
The <emphasis>id</emphasis> attribute must  be a valid SGML identifier and
must be unique  within the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>interp</emphasis></entry>
<entry align="left" valign="top">NOTATION -</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The interpreter to which to pass the</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">tcl</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">CDATA content of the <literal>switch</literal>
element. It is expected that the</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">interpreter returns a numeric string value</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">ksh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">equal to or greater than zero. One of the</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">csh</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">listed interpreters is often embedded in
the application and does not require another process to execute. If the specified
interpreter does not exist, or  returns either a non-numeric or out-of-bounds
 value, the default return value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>branches</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">A list of IDs in the current document. The
return  value of the <emphasis>interp</emphasis> attribute is used to index
into  this list of IDs and the hyperlink is continued at  the resulting ID.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>GENERATED ELEMENTS</title>
<para></para>
</refsect1>
<refsect1>
<title>REL-DOCS</title>
<refsect2>
<title>Purpose</title>
<para>Documents related to this document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<para>To be determined.</para>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>To be determined.</para>
<refsect2>
<title>REL-FILE</title>
<para></para>
</refsect2>
<refsect2>
<title>Purpose</title>
<para>Files related to this document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<para>To be determined.</para>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>To be determined.</para>
</refsect1>
<refsect1>
<title>NOTES</title>
<refsect2>
<title>Purpose</title>
<para>Notes related to this document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<para>To be determined.</para>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>To be determined.</para>
</refsect1>
<refsect1>
<title>LOIDS AND ID</title>
<refsect2>
<title>Purpose</title>
<para>List of identifiers in the document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="150*">
<colspec align="left" colwidth="306*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT</literal> <literal>loids</literal></entry>
<entry align="left" valign="top"><literal><!--- - (id*) >--></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="155*">
<colspec align="left" colwidth="49*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="168*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST loids</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">count</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="127*">
<colspec align="left" colwidth="329*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT id</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<colspec align="left" colwidth="131*">
<colspec align="left" colwidth="59*">
<colspec align="left" colwidth="94*">
<colspec align="left" colwidth="48*">
<colspec align="left" colwidth="124*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST id</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">(virpage</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">block</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">form</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">p</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cp</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">subhead</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">anchor</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">switch</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">snref</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">graphic</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">audio</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">video</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">animate</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">crossdoc</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">man-page</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">textfile</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sys-cmd</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">script</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">callback</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rid</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">offset</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>loids</literal> element is a container for a list of identifiers
in the document. The list appears in the order the identifiers appear.</para>
<para>The <literal>loids</literal> element can be used to generate a table
of contents for the document by selecting only those elements whose
<symbol role="Variable">type</symbol> is <literal>virpage</literal> and listing the
heads of those <literal>virpage</literal> elements. The <emphasis>rlevel</emphasis>
attribute can be used to infer the nesting level of the <literal>virpage</literal>
and to avoid reading the <literal>head</literal> of virtual pages whose nesting
<symbol role="Variable">level</symbol> is deeper than is currently being displayed.
</para>
<para>The attribute of <literal>loids</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.14in">
<colspec align="left" colwidth="55*">
<colspec align="left" colwidth="89*">
<colspec align="left" colwidth="78*">
<colspec align="left" colwidth="284*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">count</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The number of <literal>id</literal> elements
contained in the <literal>loids</literal>.  This attribute, if present, can
be used by the processor to pre-allocate space for the <literal>id</literal>
elements.</entry></row></tbody></tgroup></informaltable>
<para>The attributes of <literal>id</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.07in">
<colspec align="left" colwidth="49*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="88*">
<colspec align="left" colwidth="283*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">type</symbol></entry>
<entry align="left" valign="top">virpage</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The name of the element to which this <literal>id</literal></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">block</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">belongs.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">form</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">p</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cp</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">subhead</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">anchor</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">switch</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">snref</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">graphic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">audio</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">video</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">animate</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">crossdoc</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">man-page</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">textfile</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sys-cmd</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">script</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">callback</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>rid</emphasis></entry>
<entry align="left" valign="top">IDREF</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The referenced identifier.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>rssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The source semantic identifier ( <emphasis>ssi</emphasis>) of the element  referenced by the <emphasis>rid</emphasis>
attribute.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The <symbol role="Variable">level</symbol>
of the element referenced by the <emphasis>rid</emphasis> attribute. This
attribute defaults to 1.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">offset</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The byte offset in the document to the start
of the  virtual page containing the element referenced by  the <emphasis>rid</emphasis> attribute.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>INDEX AND ENTRY</title>
<refsect2>
<title>Purpose</title>
<para>Contains the index for the document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="159*">
<colspec align="left" colwidth="297*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT index</literal></entry>
<entry align="left" valign="top"><literal>- - (entry*) ></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="155*">
<colspec align="left" colwidth="62*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="154*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST index</literal></entry>
<entry align="left" valign="top"><emphasis>head</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">count</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.39in">
<colspec align="left" colwidth="152*">
<colspec align="left" colwidth="375*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT entry</literal></entry>
<entry align="left" valign="top"><literal>- - ((key | sphrase | rev |  if
| spc | snref | #PCDATA)*, entry*) ></literal></entry></row></tbody></tgroup><?Pub Caret>
</informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="155*">
<colspec align="left" colwidth="55*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="162*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST entry</literal></entry>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">main</symbol></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>locs</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>syns</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>sort</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>index</literal> element contains all information necessary
to create and display an index for the document. It is created during translation
of a higher level DTD-conforming document to conform to SDL; that is, an index
is not generated at the time of request.</para>
<para>The <literal>index</literal> can be used to enable keyword searches
within a document.</para>
<para>An index consists of zero or more entries.</para>
<para>The attributes of <literal>index</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.21in">
<colspec align="left" colwidth="61*">
<colspec align="left" colwidth="91*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="275*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>head</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Alternate text for the heading of the index.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">count</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The number of <literal>entry</literal> elements
contained in the  index. The processor cn use this attribute (if this attribute
is present) to pre-allocate space for the <literal>entry</literal>  elements.</entry></row></tbody></tgroup></informaltable>
<para>The attributes of <literal>entry</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.13in">
<colspec align="left" colwidth="43*">
<colspec align="left" colwidth="66*">
<colspec align="left" colwidth="78*">
<colspec align="left" colwidth="318*">
<tbody>
<row>
<entry align="left" valign="top"><emphasis>id</emphasis></entry>
<entry align="left" valign="top">ID</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The identifier of the index entry.</entry>
</row>
<row>
<entry align="left" valign="top"><symbol role="Variable">main</symbol></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A list of identifiers specifying where the
indexed  entry may be found. The main list of ids may be  highlighted in some
way to indicate a greater  importance than the ids found in the <emphasis>locs</emphasis> list.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>locs</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A list of identifiers specifying where the
indexed  entry may be found. At least one of either <symbol role="Variable">main</symbol> or  <emphasis>locs</emphasis> must be specified.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>syns</emphasis></entry>
<entry align="left" valign="top">IDREFS</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A list of identifiers that refer to other <literal>entry</literal> elements and correspond to a ``See also'' or synonym-type
of reference.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>sort</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A <emphasis>sort</emphasis> key to use if
the indexed entry is to be  sorted other than by its content.</entry></row>
</tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>LOPHRASES</title>
<refsect2>
<title>Purpose</title>
<para>A list of semantic phrases used in this document.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="189*">
<colspec align="left" colwidth="267*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT lophrases</literal></entry>
<entry align="left" valign="top"><literal>- - (phrase+) ></literal></entry>
</row></tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="196*">
<colspec align="left" colwidth="50*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="126*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST lophrases</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">count</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The list of phrases ( <literal>lophrases</literal>) element is generated
by the higher level DTD to SDL translator. It is a list of phrases used from
the <literal>toss</literal> element (covered later in this document) contained
in this document. The phrases are used to map the user's knowledge domain
into the constructs used in SDL. This information can be used to pass the
phrases available for structured or semantic searches to a browser or viewer
to allow that browser or viewer to offer that information to the user.</para>
<para>The <literal>lophrases</literal> element differs from the phrases in
the <literal>toss</literal> in that the <literal>toss</literal> contains all
phrases possible in a higher level DTD to SDL translation and the <literal>lophrases</literal> element contains only those used in the translation of
this particular document.</para>
<para>The attribute of <literal>lophrases</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.25in">
<colspec align="left" colwidth="53*">
<colspec align="left" colwidth="86*">
<colspec align="left" colwidth="76*">
<colspec align="left" colwidth="300*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">count</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The number of phrase elements contained in
the  <literal>lophrases</literal>. The processor can use this attribute (if
this attribute is present) to pre-allocate space for the  phrase elements.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>PHRASE</title>
<refsect2>
<title>Purpose</title>
<para>A single phrase in the <literal>lophrases</literal> element.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="2.01in">
<colspec align="left" colwidth="3.48in">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT phrase</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="168*">
<colspec align="left" colwidth="45*">
<colspec align="left" colwidth="74*">
<colspec align="left" colwidth="169*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST phrase</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">text</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">#REQUIRED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>phrase</literal> element is a single phrase from the list
of phrases element ( <literal>lophrases</literal>).</para>
<para>The attribute of <literal>phrase</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<colspec align="left" colwidth="46*">
<colspec align="left" colwidth="82*">
<colspec align="left" colwidth="90*">
<colspec align="left" colwidth="238*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">text</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The semantic phrase.</entry></row></tbody>
</tgroup></informaltable>
</refsect1>
<refsect1>
<title>TOSS</title>
<refsect2>
<title>Purpose</title>
<para>The table of semantics and styles.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.35in">
<colspec align="left" colwidth="156*">
<colspec align="left" colwidth="368*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT toss</literal></entry>
<entry align="left" valign="top"><literal>- - (keystyle*, headstyle*, frmtstyle*,
grphstyle*)></literal></entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>toss</literal> element is a container for the table of
semantics and styles. Each sub-element of the <literal>toss</literal> represents
a different formatting group. These sub-elements also contain <symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> (source semantic identifier) attributes
to allow general and specific semantic or structured searches. A <emphasis>phrase</emphasis> attribute of many of the <literal>toss</literal> sub-elements
also assists by providing a natural language phrase to describe the semantics
of the element as used in the higher level DTD to SDL translation.</para>
<para>Lookups in the <literal>toss</literal> are done by matching the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> attributes of
the element in the document proper with the <symbol role="Variable">class</symbol>
and <emphasis>ssi</emphasis> attributes of the sub-element of the <literal>toss</literal>. The lookup can often be further refined by matching the
<symbol role="Variable">level</symbol> attribute (if present) of the element in the
document with the <emphasis>rlevel</emphasis> attribute (if present) in the
sub-element of the <literal>toss</literal>.</para>
<para>Structured searches based on the structure of a domain-specific higher
level DTD can be made by having the <emphasis>ssi</emphasis> attribute of
the sub-element directly correspond to the generic identifier from the original
DTD.</para>
<para>The attribute of <literal>toss</literal> is:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="1">
<?PubTbl tgroup dispwid="6.13in">
<colspec align="left" colwidth="52*">
<colspec align="left" colwidth="86*">
<colspec align="left" colwidth="73*">
<colspec align="left" colwidth="294*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">count</symbol></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The number of styles contained in the <literal>toss</literal>. The processor can use this attribute (if this attribute is
present) to pre-allocate space for the styles.</entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>KEYSTYLE</title>
<refsect2>
<title>Purpose</title>
<para>Provides font and semantic information for key phrases.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="182*">
<colspec align="left" colwidth="274*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT keystyle</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.13in">
<colspec align="left" colwidth="180*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="97*">
<colspec align="left" colwidth="22*">
<colspec align="left" colwidth="121*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST keystyle</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(acro</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">book</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">emph</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">jargon</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">l10n</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">name</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">quote</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">product</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">termdef</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">term</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-in</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-out</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-cont</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">pub-lit</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefkey</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xldfi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenami</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">(serif</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">(monospace</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">(medium</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">(roman</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">(underline</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>keystyle</literal> element provides semantic and font information
for <literal>key</literal> phrases in the document.</para>
<para>When a <literal>key</literal> element is encountered in the document,
the <literal>toss</literal> list of <literal>keystyle</literal> elements is
ssearched with an attempt made to match the <symbol role="Variable">class</symbol>
and <emphasis>ssi</emphasis> (if any) attributes of the <literal>key</literal> element to the <symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> (if any) attributes of the <literal>keystyle</literal>. If
the <literal>keystyle</literal> specifies an <emphasis>rlevel</emphasis> attribute,
the search is further refined by matching the <symbol role="Variable">level</symbol>
of the <literal>block</literal> containing the paragraph ( <literal>p</literal>) to the <emphasis>rlevel</emphasis> of the <literal>keystyle</literal>.
If the <literal>key</literal> element has no <emphasis>ssi</emphasis> attribute,
the search in the <literal>toss</literal> looks for a <literal>keystyle</literal>
element with no <emphasis>ssi</emphasis> specified. A <literal>keystyle</literal>
element with no <emphasis>ssi</emphasis> specified matches any <emphasis>ssi</emphasis> in a <literal>key</literal> element although an explicit <symbol role="Variable">class</symbol>/<emphasis>ssi</emphasis> pair is chosen in
preference.</para>
<para>When a match is found, the font information contained in the <literal>keystyle</literal> is used in formatting the <literal>key</literal> element.
</para>
<para>The attributes of <literal>keystyle</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.08in">
<colspec align="left" colwidth="73*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="81*">
<colspec align="left" colwidth="262*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">acro</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The general type of the <literal>key</literal>
element in</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">book</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">the document.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">emph</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">jargon</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">l10n</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">name</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">quote</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">product</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">pub-lit</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">termdef</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">term</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-in</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-out</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">mach-cont</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefkey</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup conforms to a domain-specific DTD, the <emphasis>ssi</emphasis> may
be  used to enable structured searches of the SDL-conforming document by preserving
the original  generic identifiers.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Used to further refine matches of the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis>  attributes. If
present, the <emphasis>rlevel</emphasis> of the <literal>keystyle</literal>
is  matched against the <symbol role="Variable">level</symbol> of the <literal>block</literal> containing  the paragraph (<literal>p</literal>) containing
the <literal>key</literal> element.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A natural language phrase describing the
semantics (meaning) of the element in the original  SGML document that was
translated into this  <literal>key</literal>. This phrase can be used to present
an interface to  the reader for searching or otherwise examining  the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A number indicating the likelihood that this
element contains an actual hit when doing a full-text  search. It may be used
as a relevance indicator.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The height of the font in points. By default,
the  main body of the document is 10 point.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The width of the font in points; the default
is the  point size. The set width is similar to point size  but refers to
relative width rather than height. For example, an 8 point font based on a
square would  be 8 pt., 8 set.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">One of the 42 common desktop environment
 (CDE) colors or RGB:rrrr/gggg/bbbb.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be specified
as a group.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfdi</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">They are X logical font descriptions</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>xlfdb</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">(XLFD) typeface names for use on the X</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>xlfdib</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">Window System. Specified, for example, as
``-adobe-helvetica-bold-i-narrow-*-''. The four specifications are for normal,
italic, bold and bold-italic. These attributes should only be specified if
the  author is sure of exactly what font is desired. In the usual case, only
the logical typeface specifcations (<symbol role="Variable">style</symbol>, <emphasis>spacing</emphasis>, <emphasis>weight</emphasis>, <emphasis>slant</emphasis>)
are  given.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be specified
as a group.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenami</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">They are the MS-Windows typeface name with
a maximum</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenamb</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">of 32 characters. There is one specification
each</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenamib</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">for  normal, italic, bold and bold-italic.
These attributes should only be specified if the author is sure of the desired
font and, in the usual case, only provides the  following logical type specifications.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">serif</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The font style.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">monospace</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies fixed versus proportional</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">spacing.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">medium</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies normal versus bold font.</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">roman</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies Roman, italic or reverse italic</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">font.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">underline</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Special attribute of the font. The underline
value is</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">interpreted as appropriate for the font.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">Some non-European fonts use overlining for
 the purpose filled by underlining in European  fonts.</entry></row></tbody>
</tgroup></informaltable>
</refsect1>
<refsect1>
<title>HEADSTYLE</title>
<refsect2>
<title>Purpose</title>
<para>Provides formatting, font and semantic information for headings ( <literal>head</literal> and <literal>subhead</literal>).</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="190*">
<colspec align="left" colwidth="266*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT headstyle</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.58in">
<colspec align="left" colwidth="196*">
<colspec align="left" colwidth="83*">
<colspec align="left" colwidth="121*">
<colspec align="left" colwidth="35*">
<colspec colwidth="108*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST headstyle</literal></entry>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">(label</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">caption</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">undefhead</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>orient</emphasis></entry>
<entry align="left" valign="top">(left-orient</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-orient</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-orient</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-corner-orient</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-corner-orient</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>vorient</emphasis></entry>
<entry align="left" valign="top">(top-vorient</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vorient</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vorient</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">placement</symbol></entry>
<entry align="left" valign="top">(object</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">parent</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>headw</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>stack</emphasis></entry>
<entry align="left" valign="top">(horiz</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vert</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>flow</emphasis></entry>
<entry align="left" valign="top">(wrap</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">nowrap</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xldfi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenami</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">(serif</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">(monospace</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">(medium</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">(roman</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">(underline</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>f-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">(no-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>justify</emphasis></entry>
<entry align="left" valign="top">(left-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">numeric-justify</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">(top-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>headstyle</literal> element provides semantic, font and
formatting information for headings ( <literal>head</literal> and <literal>subhead</literal>) in the document.</para>
<para>When a heading is encountered in the document and that heading has an <emphasis>ssi</emphasis> attribute, the <literal>toss</literal> list of <literal>headstyle</literal> elements is searched with an attempt made to match the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> attributes of
the heading to the <symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> attributes of the <literal>headstyle</literal>. If the <literal>headstyle</literal> specifies an <emphasis>rlevel</emphasis> attribute, the
search is further refined by matching the <symbol role="Variable">level</symbol>
of the element containing the heading to the <emphasis>rlevel</emphasis>
of the <literal>headstyle</literal>. If the element containing the heading
does not have a <symbol role="Variable">level</symbol> attribute, the
<symbol role="Variable">level</symbol> of its containing element is used, and so on.
A <literal>headstyle</literal> element with no <emphasis>ssi</emphasis> specified
matches any <emphasis>ssi</emphasis> in a <literal>head</literal> element
although an explicit <symbol role="Variable">class</symbol>/<emphasis>ssi</emphasis> pair is chosen in preference.</para>
<para>When a match is found, the font and style information contained in the <literal>headstyle</literal> is used in formatting the heading.</para>
<para>The attributes of <literal>headstyle</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="7.52in">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="128*">
<colspec align="left" colwidth="88*">
<colspec align="left" colwidth="325*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">label</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The general type of the heading in the</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">head</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">document.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">annotation</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">phead</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefhead</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup was conforming to a domain-specific DTD, the <emphasis>ssi</emphasis>
may be  used to enable structured searches of the SDL-conforming document
by preserving the original  generic identifiers.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Used to further refine matches of the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis>  attributes. If
present, the <emphasis>rlevel</emphasis> of the <literal>headstyle</literal>
is matched against the <symbol role="Variable">level</symbol> of the element
containing the heading or, if none, the <symbol role="Variable">level</symbol>
of the first  containing element with a <symbol role="Variable">level</symbol>
attribute.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A natural language phrase describing the
semantics (meaning) of the element in the original  SGML document that was
translated into this  heading. This phrase can be used to present an interface
to  the reader for searching or otherwise examining  the document.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A number indicating the likelihood that this
element contains an actual hit when doing a full-text search.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A number indicating the likelihood that this
element contains an actual hit when doing a full-text search.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>orient</emphasis></entry>
<entry align="left" valign="top">left-orient</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The horizontal orientation of the <literal>head</literal> with</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-orient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">respect to its associated element or of</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-orient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">the <literal>subhead</literal> with respect
to its <literal>head</literal>. The</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-margin-orient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">default is center-orient. This value is used
in</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-margin-orient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">conjunction with the <emphasis>vorient</emphasis>attribute
to orient the heading. The corner orientations</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-corner-orient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">are to place the heading in one of the four</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-corner-orient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">corners above or below (top-vorient or bottom-vorient)
and to the right or left (right-corner-orient or left-corner-orient) of the
associated element. The margin orientations left or right justified this heading
with respect to  the text of the heading parent. For example, a headstyle
with orient=left-margin-orient and vorient=top-vorient  places the heading
above the parent element aligning the left margins of the parent and the heading.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>vorient</emphasis></entry>
<entry align="left" valign="top">top-vorient</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The vertical orientation of the <literal>head</literal></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vorient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">with respect to its associated element or
of the <literal>subhead</literal> with respect to its <literal>head</literal>.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vorient</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is top-vorient.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">placement</symbol></entry>
<entry align="left" valign="top">object</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">This attribute applies only to <literal>head</literal> elements.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">parent</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">This attribute indicates whether the <emphasis>orient</emphasis> and <emphasis>vorient</emphasis> attributes apply to the <literal>head</literal> proper or to  the entire <literal>head</literal> object, including
all its <literal>subhead</literal> elements. This attribute should default
to parent.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>headw</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The percentage of the available space for
the current  element that should be given to its <literal>head</literal> or
the  percentage of the <literal>head</literal> that should be given to its
 <literal>subhead</literal>. It is expressed as a fixed point number  1 to
10000 with an implied decimal point two  places to the left of the right side.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>stack</emphasis></entry>
<entry align="left" valign="top">horiz</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Where to put this <literal>head</literal>
or <literal>subhead</literal> if it</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vert</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">collides with one already placed. Horizontal
 stacking means place this one to the right of the  other. Vertical stacking
 means place this one under the other. This attribute should default to vert.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>flow</emphasis></entry>
<entry align="left" valign="top">wrap</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies whether the text of the containing</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">nowrap</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">element should flow around the heading or</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">join</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">not. The default is no-wrap. A <emphasis>flow</emphasis> of join implies starting the content of the surrounding element
immediately after this head. That is, on the same line as the bottom of this
head.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The height of the font in points. By default,
the  main body of the document is 10 point.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The width of the font in points; the default
is the  point size. The set width is similar to point size  but refers to
relative width rather than height. For  example, an 8 point font based on
a square would  be 8 pt., 8 set.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">One of the 42 CDE colors or RGB:rrrr/gggg/bbbb.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be specified
as a</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">xlfdi</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">group. They are X logical font description</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">xlfdb</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">(XLFD) typeface names for use on the X Window
System. Specified, for example, as</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">xlfdib</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">``-adobe-helvetica-bold-i-narrow-*-''. The
four specifications are for normal, italic, bold and bold-italic. This attribute
should only be specified if the  author is sure of the desired font. In the
usual case, only the logical typeface specifications ( <symbol role="Variable">style</symbol>, <emphasis>spacing</emphasis>, <emphasis>weight</emphasis>, <emphasis>slant</emphasis>) is given.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be specified
as a</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">typenami</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">group. They are the MS-Windows typeface</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">typenamb</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">name with a maximum of 32 characters. There
is</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">typenamib</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">one specification each for normal, italic,
bold and bold-italic. These attributes should only be specified if the author
is sure of the desired font and, in the usual case, only provide the following
logical type specifications.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">serif</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The font style.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">monospace</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies fixed versus proportional spacing.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">medium</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies normal versus bold font.</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">roman</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies Roman, italic or reverse italic
font.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">underline</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Special attribute of the font. The underline
value is</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">interpreted as appropriate for the font.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">Some non-European fonts use overlining for
 the purpose filled by underlining in European  fonts.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>f-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The first line margin (it may be negative).
A number used to indicate the extension or indentation at the start of a paragraph.
The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The left margin. This value is additive,
that is, if  an element has a left margin and is (logically)  contained in
another element having a left margin, the contained element will have a left
margin  equal to the sum of the two values. This value is measured in current
character  widths. The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The right margin. This value is additive,
that is, if  an element has a right margin and is (logically)  contained in
another element having a right margin, the contained element will have a right
margin equal to the sum of the two values. This value is measured in current
character  widths. The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The top margin. This value takes the maximum,
 that is, if an element has a top margin and is (logically) contained in another
element having a top  margin, the two elements together have a top  margin
equal to the greater of the two. This value is measured in current line height.
 The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The bottom margin. This value takes the maximum,
that is, if an element has a bottom margin  and is (logically) contained in
another element  having a bottom margin, the two elements  together have a
bottom margin equal to the  greater of the two. This value is measured in
current line height.  The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">no-border</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies the decoration type. The default
is no-border.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>justify</emphasis></entry>
<entry align="left" valign="top">left-justify</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Horizontal justification of the text or data.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-justify</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is left-justify. The numeric-justify</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-justify</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">value implies alignment of decimal points.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">numeric-justify</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">top-vjust</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The alignment of the <literal>head</literal>
or <literal>subhead</literal></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in the space carved out by the largest <literal>head</literal></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">or <literal>subhead</literal> in the same
plane. That is, should this <literal>head</literal> or
<literal>subhead</literal> be aligned with the top of the largest related
<literal>head</literal> or <literal>subhead</literal>, the bottom, or the
center. In general, the <emphasis>vjust</emphasis> attribute may be seen as
justifying text vertically. If a <literal>head</literal> or
<literal>subhead</literal> is being placed alongside another
<literal>head</literal> or <literal>subhead</literal> and the other one
is longer than the one being placed,
the one being placed has an  implicit length equal
to that of the already placed  one and the <emphasis>vjust</emphasis> attribute
justifies the text within  that length.</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>FORMSTYLE</title>
<refsect2>
<title>Purpose</title>
<para>Provides formatting, font and semantic information for form elements.
</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="189*">
<colspec align="left" colwidth="267*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT formstyle</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.47in">
<colspec align="left" colwidth="190*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="119*">
<colspec align="left" colwidth="40*">
<colspec align="left" colwidth="103*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST formstyle</literal></entry>
<entry align="left" valign="top"><emphasis>(class</emphasis></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srch-w</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xldfi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenami</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">(serif</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">(monospace</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">(medium</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">(roman</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">(underline</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>f-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">(no-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">(top-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>formstyle</literal> element provides semantic, font and
formatting information for <literal>form</literal> elements.</para>
<para>When a <literal>form</literal> element is encountered in the document
and that element has an <emphasis>ssi</emphasis> attribute, the <literal>toss</literal> list of <literal>formstyle</literal> elements is searched with
an attempt made to match the <symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> attributes of the element to the <symbol role="Variable">class</symbol>
and <emphasis>ssi</emphasis> attributes of the <literal>formstyle</literal>. If the <literal>formstyle</literal> specifies an <emphasis>rlevel</emphasis> attribute, the search is further refined by matching the nesting
<symbol role="Variable">level</symbol> of the <literal>form</literal> to the <emphasis>rlevel</emphasis> of the <literal>formstyle</literal>. A <literal>formstyle</literal> element with no <emphasis>ssi</emphasis> specified, matches any <emphasis>ssi</emphasis> in a <literal>form</literal>, although an explicit
<symbol role="Variable">class</symbol>/<emphasis>ssi</emphasis> pair is chosen in
preference.</para>
<para>When a match is found, the font and style information contained in the <literal>formstyle</literal> is used in formatting the element.</para>
<para>The attributes of <literal>formstyle</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.79in">
<colspec align="left" colwidth="76*">
<colspec align="left" colwidth="120*">
<colspec align="left" colwidth="75*">
<colspec align="left" colwidth="289*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The general function of the <literal>form</literal> in the</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">document.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator.  It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup conforms to a domain specific DTD, the <emphasis>ssi</emphasis> may
be  used to enable structured searches of the SDL-conforming document by preserving
the original  generic identifiers.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Used to further refine matches of the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis>  attributes. If
present, the <emphasis>rlevel</emphasis> of the <literal>formstyle</literal>
is matched against the nesting <symbol role="Variable">level</symbol> of the <literal>form</literal> being formatted.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A natural language phrase describing the
semantics (meaning) of the element in the original  SGML document that was
translated into this  <literal>form</literal>. This phrase can be used to
present an interface to  the reader for searching or otherwise examining
the document.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A number indicating the likelihood that this
element contains an actual hit when doing a full-text search.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>colw</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Column widths. One specification for each
column in the <literal>form</literal>. Amounts given for each column  are
summed and each column is then given a  fraction of the available formatting
space equal to  its specification divided by the total. Specifications take
the form D[,T[,G]] where ``D'' is the  desired (optimal) column width, ``T''
is the  amount the column is willing to grow (take) and,  if ``G'' is unspecified,
willing to give (that is, plus  or minus). ``G'' is the amount the column
is willing to shrink (give). Column specifications are delimited by a space.
For example, a specification of: COLW=``10 90'' implies two columns with the
first taking 10% of  the available space and the second taking 90%. If either
column has a graphic or unsplittable word  that pushes it over the size specified,
a horizontal  scrollbar is added and the available space is  grown until the
requirement can be met. A specification of: COLW=``20,5 80,5'' implies two
columns with the first optimally taking 20% and the second optimally taking
80%. Each column, however is willing to shrink or  grow such that the ranges
of sizes run from 15/85  to 25/75. If the sizes cannot be adjusted to contain
a graphic or unsplittable word, a horizontal scrollbar is  added and the available
space is grown until the requirement is met. Finally, a specification of:
COLW=``20,10,5 80,5,10'' implies two columns with the first optimally taking
20% of the available space but willing to take  as much as 30% or a little
as 15%. The second  column desires 80% but is willing to take as  much as
85% or as little as 70% of the available  space. A scrollbar may be added
to  the viewed space if the constraints cannot be met. The specifications
need not all be uniformly singles, doubles or triples. That is, a legal specification
could take the form: COLW=``20,5 80,0,5'' that translates to two columns;
the first  desiring 20% of the available space but willing to  take as much
as 25% or as little as 15/80  (18.75%). The second column desires 80% of the
 available space, but is willing to take as little as  75%. The totals in
the above examples usually  add up to 100. This value is mere convention for
 ease of use. In practice, the sum of desired points  may be any number. If
the number of columns specified is greater than  the <emphasis>ncols</emphasis>
attribute of the <literal>fstyle</literal> of the related  <literal>form</literal>,
the extra specifications are ignored. If the  number of columns specified
is less than the  <emphasis>ncols</emphasis> attribute, the final specification
is replicated  to cover the actual number of columns.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>colj</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The column justification is the default justification
applied to each cell in the column. This  attribute is a list of <emphasis>ncols</emphasis> letters chosen from: ``l,'' ``r,'' ``c,'' and ``d.'' These
letters specify left, right, centered and decimal justification,  respectively.
This attribute defaults to ``l.''</entry></row>
<row>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The height of the font in points. By default,
the  main body of the document is 10 point.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The width of the font in points; the default
is the  point size. The set width is similar to point size  but refers to
relative width rather than height. For  example, an 8 point font based on
a square would  be 8 pt., 8 set.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">One of the 42 common desktop environment
 (CDE) colors or RGB:rrrr/gggg/bbbb.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>xlfdi</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">specified as a group. They are X logical</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfdb</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">font descriptions  (XLFD) typeface names</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfdib</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">for use on the X Window System. Specified,
for example, as ``-adobe-helvetica-bold-i-narrow-*-''. The four specifications
are for normal, italic, bold and bold-italic.  These attribute should only
be specified if the  author is sure of exactly what font is desired. In the
usual case, only the logical typeface specifications ( <symbol role="Variable">style</symbol>, <emphasis>spacing</emphasis>, <emphasis>weight</emphasis>, <emphasis>slant</emphasis>) is  given.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be specified</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenami</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">as a group with a maximum of 32</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>typenamib</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">characters. There is one specification each
for  normal, italic, bold and bold-italic. These attributes should only be
specified if the author is sure of the desired font  and, in the usual case,
only provides the  following logical type specifications.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">serif</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The font style.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">monospace</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies fixed versus proportional spacing.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">medium</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies normal versus bold font.</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">roman</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies Roman, italic or reverse italic
font.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">underline</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Special attribute of the font. The underline</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">value is interpreted as appropriate for the
font.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">Some non-European fonts use overlining for</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">the purpose filled by underlining in European</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">fonts.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The left margin. This value is additive,
that is, if  an element has a left margin and is (logically)  contained in
another element having a left margin, the contained element will have a left
margin  equal to the sum of the two values. This value is measured in current
character  widths and defaults to zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The right margin. This value is additive,
that is, if  an element has a right margin and is (logically)  contained in
another element having a right margin, the contained element will have a right
margin equal to the sum of the two values. This value is measured in current
character  widths and defaults to zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The top margin. This value takes the maximum,
 that is, if an element has a top margin and is (logically) contained in another
element having a top  margin, the two elements will together have a top  margin
equal to the greater of the two. This value is measured in current line height
and  defaults to zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The bottom margin. This value takes the maximum,
that is, if an element has a bottom margin  and is (logically) contained in
another element  having a bottom margin, the two elements together have a
bottom margin equal to the  greater of the two. This value is measured in
current line height and  defaults to zero.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">no-border</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies the decoration type.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">no-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is no-border.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">top-vjust</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Vertical justification of the text of this</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">element. The default is top-vjust.</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>FRMTSTYLE</title>
<refsect2>
<title>Purpose</title>
<para>Provides formatting, font and semantic information for <literal>virpage</literal>, <literal>block</literal> and <literal>p</literal> elements.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="234*">
<colspec align="left" colwidth="222*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT frmtstyle</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.60in">
<colspec align="left" colwidth="193*">
<colspec align="left" colwidth="80*">
<colspec align="left" colwidth="123*">
<colspec align="left" colwidth="36*">
<colspec align="left" colwidth="112*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST frmtstyle</literal></entry>
<entry align="left" valign="top"><emphasis>(class</emphasis></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xldfi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>xlfdib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenami</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamb</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>typenamib</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">(serif</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">(monospace</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">(medium</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">(roman</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">(underline</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>f-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">(no-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">(top-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>justify</emphasis></entry>
<entry align="left" valign="top">(left-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">numeric-justify</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>frmtstyle</literal> element provides semantic, font and
formatting information for <literal>virpage</literal>, <literal>block</literal>
and <literal>p</literal> elements.</para>
<para>When a one of the elements listed in the FRMSTYLE Synopsis is encountered
in the document and that element has an <emphasis>ssi</emphasis> attribute,
the <literal>toss</literal> list of <literal>frmtstyle</literal> elements
is serached with an attempt made to match the <symbol role="Variable">class</symbol>
and <emphasis>ssi</emphasis> attributes of the element to the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> attributes of
the <literal>frmtstyle</literal>. If the <literal>frmtstyle</literal> specifies
an <emphasis>rlevel</emphasis> attribute, the search is further refined by
matching the <literal>level</literal> of the element containing the element
to the <emphasis>rlevel</emphasis> of the <literal>frmtstyle</literal>. If
the element does not have a <symbol role="Variable">level</symbol> attribute,
the level of its containing element is used, and so on. A <literal>frmtstyle</literal> element with no <emphasis>ssi</emphasis> specified matches any <emphasis>ssi</emphasis> in a formattable element although an explicit <symbol role="Variable">class</symbol>/<emphasis>ssi</emphasis> pair is chosen in preference.</para>
<para>When a match is found, the font and style information contained in the <literal>frmtstyle</literal> is used in formatting the element.</para>
<para>The attributes of <literal>frmtstyle</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.90in">
<colspec align="left" colwidth="86*">
<colspec align="left" colwidth="120*">
<colspec align="left" colwidth="75*">
<colspec align="left" colwidth="288*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">table</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The general function of the <literal>form</literal> .</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">cell</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in the document.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">list</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">item</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">text</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udeffrmt</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The general function of the <literal>form</literal>. A source semantic identifier. This identifier is  chosen by the
author of a higher level DTD to  SDL translator. It may either reflect the
meaning  of the markup in the original document or it may  reflect the actual
generic identifier in the original  document. The source semantic identifier
may be used to  assist in semantic searches of the SDL-conforming document
by preserving the original intent of  the markup. When the original markup
conforms to a domain-specific DTD, the <emphasis>ssi</emphasis> may be  used
to enable structured searches of the SDL-conforming document by preserving
the original  generic identifiers.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Used to further refine matches of the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis>  attributes. If
present, the <emphasis>rlevel</emphasis> of the <literal>frmtstyle</literal>
is  matched against the <symbol role="Variable">level</symbol> of the element
being  formatted or, if none, the <symbol role="Variable">level</symbol> of
the first containing element with a <symbol role="Variable">level</symbol>
attribute.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A natural language phrase describing the
semantics (meaning) of the element in the original  SGML document that was
translated into this element. This phrase can be used to present an interface
to  the reader for searching or otherwise examining  the document.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>srch-wt</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A number indicating the likelihood that this
element contains an actual hit when doing a full-text  search.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>pointsz</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The height of the font in points. By default,
the  main body of the document is 10 point.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>set-width</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The width of the font in points; the default
is the  point size. The set width is similar to point size  but refers to
relative width rather than height. For example, an 8 point font based on a
square would  be 8 pt., 8 set.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">color</symbol></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">One of the 42  CDE colors or RGB:rrrr/gggg/bbbb.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfd</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be specified
as a group.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfdi</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">They are X logical font description (XLFD)</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfdb</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">typeface names for use on the X Window System.
Specified, for example,</entry></row>
<row>
<entry align="left" valign="top"><emphasis>xlfdib</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">as ``-adobe-helvetica-bold-i-narrow-*-''.
The four specifications are for normal, italic, bold and bold-italic. These
attributes should only be specified if the  author is sure of exactly what
font is desired. In the usual case, only the logical typeface specifications
(<symbol role="Variable">style</symbol>, <emphasis>spacing</emphasis>, <emphasis>weight</emphasis>, <emphasis>slant</emphasis>) are  given.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenam</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">These attributes should always be specified
as a group.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>typenami</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">They are the MS-Windows typeface</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>typenamb</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">names with a maximum of 32 characters.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>typenamib</emphasis></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">There is one specification each for  normal,
italic, bold and bold-italic. These attributes should only be specified if
the author is sure of the desired font. In the usual case, only the logical
typeface specifications (<symbol role="Variable">style</symbol>, <emphasis>spacing</emphasis>, <emphasis>weight</emphasis>, <emphasis>slant</emphasis>)
are  given.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">style</symbol></entry>
<entry align="left" valign="top">serif</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The font style.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">sans-serif</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">symbol</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>spacing</emphasis></entry>
<entry align="left" valign="top">monospace</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies fixed versus proportional</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">propspace</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">spacing.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>weight</emphasis></entry>
<entry align="left" valign="top">medium</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies normal versus bold font.</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bold</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>slant</emphasis></entry>
<entry align="left" valign="top">roman</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies Roman, italic or reverse italic</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">font.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">rev-italic</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>special</emphasis></entry>
<entry align="left" valign="top">underline</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Special attribute of the font. The underline
value is interpreted</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">strikeout</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">as appropriate for the  font. Some non-European</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">none</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">fonts use overlining for  the purpose filled
by underlining in European  fonts.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>f-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The first line margin (it may be negative).
A number used to indicate the extension or indentation at the start of a paragraph.
The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The left margin. This value is additive,
that is, if  an element has a left margin and is (logically)  contained in
another element having a left margin, the contained element will have a left
margin  equal to the sum of the two values. This value is measured in current
character  widths. The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The right margin. This value is additive,
that is, if  an element has a right margin and is (logically)  contained in
another element having a right margin, the contained element will have a right
margin equal to the sum of the two values. This value is measured in current
character  widths. The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The top margin. This value takes the maximum,
 that is, if an element has a top margin and is (logically) contained in another
element having a top  margin, the two elements together have a top  margin
equal to the greater of the two. This value is measured in current line height.
The default value is zero</entry></row>
<row>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The bottom margin. This value takes the maximum,
that is, if an element has a bottom margin  and is (logically) contained in
another element  having a bottom margin, the two elements  together have a
bottom margin equal to the  greater of the two. This value is measured in
current line height. The default value is zero</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">no-border</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies the decoration type.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is no-border.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">top-vjust</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Vertical justification of the text of</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">this element. The default is top-vjust.</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>justify</emphasis></entry>
<entry align="left" valign="top">left-justify</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Horizontal justification of the text or data.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-justify</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is left-justify.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-justify</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The numeric-justify value implies</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">numeric-justify</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">alignment of decimal points.</entry></row>
</tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>GRPHSTYLE</title>
<refsect2>
<title>Purpose</title>
<para>Provides formatting and semantic information for <literal>refitem</literal>
elements with a <symbol role="Variable">class</symbol> attribute value taken
from the <emphasis>graphic</emphasis> class.</para>
</refsect2>
</refsect1>
<refsect1>
<title>SYNOPSIS</title>
<informaltable remap="center" orient="port">
<tgroup cols="2" colsep="0" rowsep="1">
<colspec align="left" colwidth="188*">
<colspec align="left" colwidth="268*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ELEMENT grphstyle</literal></entry>
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
</tbody></tgroup></informaltable>
<informaltable remap="center" orient="port">
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.49in">
<colspec align="left" colwidth="188*">
<colspec align="left" colwidth="78*">
<colspec align="left" colwidth="119*">
<colspec align="left" colwidth="35*">
<colspec align="left" colwidth="115*">
<tbody>
<row>
<entry align="left" valign="top"><literal>&lt;!ATTLIST grphstyle</literal></entry>
<entry align="left" valign="top"><emphasis>(class</emphasis></entry>
<entry align="left" valign="top">figure</entry>
<entry align="left" valign="top">|</entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in-line</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">button</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">icon</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefgrph</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#REQUIRED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">(no-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">(top-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"><emphasis>justify</emphasis></entry>
<entry align="left" valign="top">(left-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-justify</entry>
<entry align="left" valign="top">|</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-justify</entry>
<entry align="left" valign="top">)</entry>
<entry align="left" valign="top">#IMPLIED ></entry></row></tbody></tgroup>
</informaltable>
</refsect1>
<refsect1>
<title>DESCRIPTION</title>
<para>The <literal>grphstyle</literal> element provides semantic, font and
formatting information for <literal>refitem</literal> elements with a
<symbol role="Variable">class</symbol> attribute taken from the <emphasis>graphic</emphasis> class.</para>
<para>When a one of the above elements is encountered in the document and
that element has an <emphasis>ssi</emphasis> attribute, the <literal>toss</literal> list of <literal>grphstyle</literal> elements is searched with
an attempt made to match the <symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis> attributes of the element to the <symbol role="Variable">class</symbol>
and <emphasis>ssi</emphasis> attributes of the <literal>grphstyle</literal>. If the <literal>grphstyle</literal> specifies an <emphasis>rlevel</emphasis> attribute, the search is further refined by matching the
<symbol role="Variable">level</symbol> of the element containing the element to the <emphasis>rlevel</emphasis> of the <literal>grphstyle</literal>. The <symbol role="Variable">level</symbol> of a <literal>refitem</literal> is taken from the <symbol role="Variable">level</symbol> of its enclosing block. If the enclosing block does not have
a <symbol role="Variable">level</symbol> attribute, the <symbol role="Variable">level</symbol> of its enclosing <literal>virpage</literal> is used. A <literal>grphstyle</literal> element with no <emphasis>ssi</emphasis> specified, matches
any <emphasis>ssi</emphasis> in a <literal>refitem</literal> element, although
an explicit <symbol role="Variable">class</symbol>/<emphasis>ssi</emphasis>
pair is chosen in preference.</para>
<para>When a match is found, the style information contained in the <literal>grphstyle</literal> is used in formatting the graphic.</para>
<para>The attributes of <literal>grphstyle</literal> are:</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="6.58in">
<colspec align="left" colwidth="71*">
<colspec align="left" colwidth="115*">
<colspec align="left" colwidth="81*">
<colspec align="left" colwidth="276*">
<tbody>
<row>
<entry align="left" valign="top"><symbol role="Variable">class</symbol></entry>
<entry align="left" valign="top">figure</entry>
<entry align="left" valign="top">Required</entry>
<entry align="left" valign="top">The general function of the graphic</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in-line</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">in the document.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">button</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">icon</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">udefgrph</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>ssi</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A source semantic identifier. This identifier
is  chosen by the author of a higher level DTD to  SDL translator. It may
either reflect the meaning  of the markup in the original document or it may
 reflect the actual generic identifier in the original  document. The source
semantic identifier may be used to  assist in semantic searches of the SDL-conforming
document by preserving the original intent of  the markup. When the original
markup was conforming to a domain-specific DTD, the <emphasis>ssi</emphasis>
may be  used to enable structured searches of the SDL-conforming document
by preserving the original  generic identifiers.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>rlevel</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Used to further refine matches of the
<symbol role="Variable">class</symbol> and <emphasis>ssi</emphasis>  attributes. If
present, the <emphasis>rlevel</emphasis> of the <literal>grphstyle</literal>
is matched against the <symbol role="Variable">level</symbol> of the first
containing  element with <symbol role="Variable">level</symbol> attribute.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>phrase</emphasis></entry>
<entry align="left" valign="top">CDATA</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">A natural language phrase describing the
semantics (meaning) of the element in the original  SGML document that was
translated into this element. This phrase can be used to present an interface
to  the reader for searching or otherwise examining  the document.</entry>
</row>
<row>
<entry align="left" valign="top"><emphasis>l-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The left margin. This value is additive,
that is, if  an element has a left margin and is (logically)  contained in
another element having a left margin, the contained element will have a left
margin  equal to the sum of the two values. This value is measured in current
character  widths. The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>r-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The right margin. This value is additive,
that is, if  an element has a right margin and is (logically)  contained in
another element having a right margin, the contained element will have a right
margin equal to the sum of the two values. This value is measured in current
character  widths. The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>t-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The top margin. This value takes the maximum,
 that is, if an element has a top margin and is (logically) contained in another
element having a top  margin, the two elements together have a top  margin
equal to the greater of the two. This value is measured in current line height.
The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><emphasis>b-margin</emphasis></entry>
<entry align="left" valign="top">NUMBER</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">The bottom margin. This value takes the maximum,
that is, if an element has a bottom margin  and is (logically) contained in
another element  having a bottom margin, the two elements  together have a
bottom margin equal to the  greater of the two. This value is measured in
current line height. The default value is zero.</entry></row>
<row>
<entry align="left" valign="top"><symbol role="Variable">border</symbol></entry>
<entry align="left" valign="top">no-border</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Specifies the decoration type.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">full-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is no-border.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">horizontal-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">vertical-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">top-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">left-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-border</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>vjust</emphasis></entry>
<entry align="left" valign="top">top-vjust</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Vertical justification of the graphic.</entry>
</row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">bottom-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is top-vjust.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-vjust</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row>
<row>
<entry align="left" valign="top"><emphasis>justify</emphasis></entry>
<entry align="left" valign="top">left-justify</entry>
<entry align="left" valign="top">Optional</entry>
<entry align="left" valign="top">Horizontal justification of the graphic.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">right-justifyt</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">The default is left-justify.</entry></row>
<row>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top">center-justify</entry>
<entry align="left" valign="top"></entry>
<entry align="left" valign="top"></entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>&cdeman.DtCreateHelpDialog;, &cdeman.DtCreateHelpQuickDialog;.</para>
</refsect1>
</refentry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 01:31:55-->
<?Pub *0000401967>