8202 lines
364 KiB
Plaintext
8202 lines
364 KiB
Plaintext
<!-- $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><!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><!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 <major>.<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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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 ``</'' character pair. If that pair
|
|
is to be included in the text, it must be preceded with an ampersand (&).
|
|
</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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!ELEMENT man-page</literal></entry>
|
|
<entry align="left" valign="top"><literal>- O EMPTY ></literal></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><literal><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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>
|