dtsdldtd man page on IRIX

dtsdldtd man page on IRIX

Man page or keyword search:
man Server 31559 pages
apropos Keyword Search (all sections)
Output format

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

NAME
dtsdldtd - Semantic Delivery Language (SDL) format and
semantics

DESCRIPTION
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.

Dependencies
None.

Issues
None.

TOP LEVEL ELEMENTS
SDLDOC
Purpose
The top of the document hierarchy.

SYNOPSIS
<!ELEMENT sdldoc - - (vstruct, head*, snb?, virpage+) >
<!ATTLIST
pub-id CDATA #REQUIRED
doc-id CDATA #REQUIRED
timestmp CDATA #REQUIRED
first-page IDREF #IMPLIED
product CDATA #IMPLIED
prodpn CDATA #IMPLIED
prodver CDATA #IMPLIED
license CDATA #IMPLIED
language CDATA #IMPLIED
charset CDATA #IMPLIED
author CDATA #IMPLIED
version CDATA #IMPLIED
sdldtd CDATA #REQUIRED
srcdtd CDATA #IMPLIED >

DESCRIPTION
The document element, sdldoc, 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.

The attributes of sdldoc are:

Page 1 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

pub-id CDATA Required The public identifier is used to
represent a document. It is
analogous to a part number.
doc-id CDATA Required The document identifier is
specific to this version
(instance) of a document. It is
analogous to a manufacturing
part number.
timestmp CDATA Required 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.
first-page IDREF Optional If specified, the first-page
attribute identifies the virtual
page to display upon first
entering the document.
product CDATA Optional A description of the product
this document describes.
prodpn CDATA Optional The part number of the product
this document describes.
prodver CDATA Optional The version level of the product
this document describes.
license CDATA Optional Product license information. By
default, no license restrictions
are applied.
language CDATA Optional The default language of the
document. This attribute may be
overridden in later elements.
The language attribute and the
charset attribute of elements
are used to select the proper
font for display.
charset CDATA Optional The default character set of the
document. This attribute may be
overridden in later elements.
The charset attribute and the
language attribute are used to
select the proper font for
display.
author CDATA Optional The source author or publisher
of the document.
version CDATA Optional The default version of this
document. This attribute may be
overridden in later elements.
sdldtd CDATA Required The version level of the SDL DTD
to which this document conforms.
This attribute is specified as
<major>.<minor> version. For

Page 2 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

example, 1.0. 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.
srcdtd CDATA Optional The name of the DTD to which the
source document conformed.

VSTRUCT
Purpose
The container for all generated elements.

SYNOPSIS
<!ELEMENT vstruct - - (loids, toss?, lophrases?, index?, rel-docs?, rel-file?, notes?) >
<!ATTLIST vstruct version CDATA #IMPLIED
doc-id CDATA #REQUIRED>

DESCRIPTION
The vstruct 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.

The attributes of vstruct are:
version CDATA Optional The version of this element. By
default, the version of the
vstruct is the same as the
version of the document
(sdldoc).
doc-id CDATA Required The document identifier of the
document to which this element
belongs.

VIRPAGE
Purpose
The smallest directly addressable unit in a document.

SYNOPSIS
<!ELEMENT virpage - - (head*, snb?, (block | form)*) >
<!ATTLIST virpage id ID #REQUIRED
level NUMBER #REQUIRED
version CDATA #IMPLIED
language CDATA #IMPLIED

Page 3 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

charset CDATA #IMPLIED
doc-id CDATA #REQUIRED
ssi CDATA #IMPLIED >

DESCRIPTION
The virtual page (virpage) 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.

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
(toss) element is available for formatting information.

A virtual page may have zero or more head elements that
provide title information and may also be used in display
decoration, such as a title bar. The first head of a
virtual page is intended to be displayed in a table of
contents for the document.

Following the head elements is an optional system notation
block (snb). The system notation block, which provides
access to objects external to the document, is covered later
in this document.

Finally, a virtual page may contain any combination of block
or form elements, including none.

The attributes of virpage are:
id ID Required The identifier of the virtual
page. The id attribute must be
a valid SGML identifier and must
be unique within the document.
To display a virtual page,
hyperlink to this id.
level NUMBER Required The hierarchical level of the
information contained in the
element. The level 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

Page 4 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

specified divisions such as
chapter, d1, d2, these would all
appear in the SDL version of the
document as virtual pages but
with levels of 1, 2 and 3,
respectively.
version CDATA Optional The version of this element. By
default, the version of the
virpage is the same as the
version of the document
(sdldoc).
language CDATA Optional The language in which this
element is written. This
attribute may be overridden
individually within the form and
block elements contained in the
virtual page.
charset CDATA Optional The default character set of the
document. This attribute may be
overridden individually within
the form and block elements
contained in the virtual page.
doc-id CDATA Required The document identifier of the
document to which this element
belongs.
ssi CDATA Optional 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 ssi may be used to
enable structured searches of
the SDL conforming document by
preserving the original generic
identifiers.

The level and ssi attributes of the virtual page are used to
look up formatting and semantic information in the table of
semantics and styles (toss) element covered later in this
document.

Page 5 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

SNB
Purpose
The container for all references to objects external to the
document.

<!ATTLIST snb version CDATA #IMPLIED >

DESCRIPTION
The system notation block (snb) provides a container for
elements that access data that are not in SGML notation.
The one exception to this rule is the text element. The
text element is in the system notation block because it is
intended for use as a rich text alternative to other
elements in the snb when elements are tried in turn during
the instantiation of a system notation reference (snref)
looking for an alternative that can be formatted on the
current system.

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 snb element is
established by a system notation reference.

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.

The optional head element may be used by an application when
presenting a list of required resources for a document.

The attribute of snb is:
version CDATA Optional The version of this element. By
default, the version of the snb
is the same as the version of
the document (sdldoc).

BLOCK
Purpose
The basic unit of display style.

SYNOPSIS
<!ELEMENT block - - (head*, (p | cp)*) >

Page 6 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
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 head elements
followed by zero or more paragraphs (p) or character
paragraphs (cp).

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 level attribute.

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.

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.

The level, class and ssi attributes of a block can be used

Page 7 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

to look up formatting and semantic information in the table
of semantics and styles (toss) element (covered later in
this document).

The attributes of block are:
id ID Optional The identifier of the block.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
level NUMBER Optional The hierarchical level of the
information contained in the
element. The level 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 block
nesting information stored in
the level attribute.
version CDATA Optional The version of this element. By
default, the version of the
block is the same as the version
of the document (sdldoc) unless
that version has been overridden
by a version attribute in the
virtual page (virpage) or form
(covered later in this document)
containing the block.
class table Optional The class of a block describes
the general
cell purpose the block is filling.
The class attribute is
list used in conjunction with the
level and ssi
item attributes to perform a lookup
in the table of
text semantics and styles (toss)
element. The result of
udeffrmt that lookup is formatting and
semantic information pertaining
to the block.
language CDATA Optional The language in which this block
was written.
charset CDATA Optional The character set of this block.
The language and charset
attributes plus information
retrieved from the table of
semantics and styles (toss)
element are used to select the

Page 8 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

font for the block.
length NUMBER Optional By default, the length of a
block is determined dynamically
as a function of its content and
rendering style. If a length
value is present, it describes
the length of the block in terms
of current style lines.
app all Optional The app attribute is used to for
selective presentation
help of a block. This attribute
defaults
tutorial to all.
timing sync Optional The timing attribute defaults to
sync.
async A block with a timing attribute
of async is only displayed when
referenced via an IDREF (or
IDREFS). For example, an async
block may be referenced by the
cells attribute of frowvec to
repeat the block without
reentering its data content.
ssi CDATA Optional 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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.

FORM
Purpose
A two dimensional array of block and/or form elements.

SYNOPSIS
<!ELEMENT form - - (head*, (fstyle, fdata) | (fdata, fstyle)) >

Page 9 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The form element is a generalized representation of a data
element that is partially preformatted. The form 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 form may be
used to represent any information that is layout sensitive
or contains data to be presented in a two dimensional
matrix.

A form is made up of zero or more head elements followed
either by a form style (fstyle) and the form data (fdata) or
the form data followed by the form style.

The attributes of form are:
id ID Optional The identifier of the form. The
id attribute must be a valid
SGML identifier and must be
unique within the document.
level NUMBER Optional The hierarchical level of the
information contained in the
element. The level 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 form
nesting information stored in
the level attribute.
version CDATA Optional The version of this element. By

Page 10 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

default, the version of the form
is the same as the version of
the document (sdldoc) unless
that version has been overridden
by a version attribute in the
virtual page (virpage)
containing the form.
class table Optional The class of a form describes
the general
cell purpose the form is filling.
The class attribute is
list used in conjunction with the
level and ssi
item attributes to perform a lookup
in the table of
text semantics and styles (toss)
element. The result of
udeffrmt that lookup is formatting and
semantic information pertaining
to the form.
language CDATA Optional The language in which this form
was written.
charset CDATA Optional The character set of this form.
The language and charset
attributes plus information
retrieved from the table of
semantics and styles (toss)
element are used to select the
font for the form.
length NUMBER Optional By default, the length of a form
is determined dynamically as a
function of its content and
rendering style. If a length
value is present, it describes
the length of the form in terms
of current style lines.
app all Optional The app attribute is used for
selective
help presentation of a form. This
attribute defaults
tutorial to all.
sys 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.

Page 11 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

ssi CDATA Optional

Page 12 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

FSTYLE
Purpose
Specify the style of a form.

SYNOPSIS
<!ELEMENT fstyle - - (frowvec+) >

DESCRIPTION
The form style (fstyle) element specifies the style of the
form. It is composed of one or more row reference vectors
(frowvec). The list of cell id references in the reference
row vectors establishes the relationship between the
position and data block for a cell.

The form style element and formstyle element in the table of
semantics and styles (toss) element (covered later in this
document) contain information regarding the presentational
style of the form. 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.

The attribute of fstyle is:
ncols NUMBER Optional The number of columns in the
form. This attribute should be
a number greater than zero.
Unless overridden by a column
width (colw) specification in
the toss, the available space is
divided evenly among the
columns. Unless overridden by a
column justification (colj)
specification in the toss, the
block and/or form elements in
the form are left justified in
their cells.

FROWVEC
Purpose
Describes the style of a row and contains ID references to
the contents of the row.

SYNOPSIS
<!ELEMENT frowvec - O EMPTY >
<!ATTLIST frowvec hdr (YES|NO) #IMPLIED
cells IDREFS #REQUIRED >

DESCRIPTION
The reference row vector (frowvec) describes the style of a
row in a form and contains pointers (id references) to the
contents of the row. There must be a row vector per row in
the form.

Page 13 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

The hdr 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 form must
scroll, covers multiple screens or is displayed as a graph.

The attributes of frowvec are:
hdr yes Optional Indicates whether or not the
associated row is a
no head row.
cells IDREFS Required A list of id references to the
block or form elements in the
fdata element that make up the
cell contents of this form.

Within a form element, spanning of rows or columns is done
by repeating the appropriate id reference in the cells
attribute of the frowvec. If the data is to be repeated in
multiple unspanned cells, the block must be repeated and
assigned unique identifiers.

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
block or form 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.

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.

The id references in a reference row may specify elements
that are not in the data container of its form, even if the
elements are not physically close. To protect the
performance of the form element, references to data outside
the current form 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 form's data element with a link or icon.

FDATA
Purpose
A container for information belonging solely to a form

Page 14 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

element.

SYNOPSIS
<!ELEMENT fdata - - ((block | form)*) >

DESCRIPTION
The form data element (fdata) is a container for information
that belongs to a form. By default, without spanning and
external references, form data is typically maintained in
row major matrix form. Assumptions about the order of the
block or form elements in the data area must not be used for
anything except performance because the blocks are allowed
to be represented in any order.

The fdata element has no attributes.

CONTAINER ELEMENTS
P
Purpose
A paragraph.

<!ATTLIST p id ID #IMPLIED
version CDATA #IMPLIED
type (literal |
lined |
dynamic ) #IMPLIED
ssi CDATA #IMPLIED >

DESCRIPTION
Paragraphs identify a formatting unit. Paragraphs collect
information that needs to be rendered contiguously within a
region. Paragraphs inherit style from their containing
block although adjustments can be made by using the class
and level attributes of the enclosing block plus the ssi
attribute of the p to effect a lookup in the table of
semantics and styles (toss) element (covered later in this
document).

Paragraphs may contain text, references and key phrases.
The key 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.

The attributes of p are:

Page 15 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

id ID Optional The identifier of the p. The id
attribute must be a valid SGML
identifier and must be unique
within the document.
version CDATA Optional The version of this element. By
default, the version of the p is
the same as the version of the
document (sdldoc) unless that
version has been overridden by a
version attribute in the virtual
page (virpage), form or block
containing the p.
type literal Optional Paragraph text may be either
unformatted or preformatted.
lined By default, paragraph text is
assumed dynamic (unformatted) to
be
dynamic and all white space (space, tab,
newline, etc.) may be replaced
with a single space. The type
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.
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
ssi may be used to enable
structured searches of the SDL
conforming document by
preserving the original generic
identifiers.

Page 16 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

ssi CDATA Optional

Page 17 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

CP
Purpose
A character paragraph.

SYNOPSIS
<!ELEMENT cp - - (CDATA) >
<!ATTLIST cp id ID #IMPLIED
version CDATA #IMPLIED
type (literal |
lined |
dynamic ) #IMPLIED
ssi CDATA #IMPLIED >

DESCRIPTION
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
(&).

The attributes of cp are:
id ID Optional The identifier of the p. The id
attribute must be a valid SGML
identifier and must be unique
within the document.
version CDATA Optional The version of this element. By
default, the version of the p is
the same as the version of the
document (sdldoc) unless that
version has been overridden by a
version attribute in the virtual
page (virpage), form or block
containing the p.
type literal Optional Paragraph text may be either
unformatted or preformatted.
lined
By default, paragraph text is
assumed to be dynamic
(unformatted)
dynamic and all white space (space, tab,
newline, etc.) may be replaced
with a single space. The type
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

Page 18 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

significant in literal
paragraphs.
ssi CDATA Optional 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
ssi may be used to enable
structured searches of the SDL-
conforming document by
preserving the original generic
identifiers.

HEAD
Purpose
Heading, label or caption.

DESCRIPTION
Heads are phrase-like elements that are associated with the
entire section that contains it. Heads may contain zero or
more subhead elements followed by zero or more paragraphs.

Page 19 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

The head element may also be used as the caption of a
graphic (covered later in this document).

The user-defined head (udefhead) value is for use by the
developer of a higher level DTD to SDL translator when an
unexpected use for a head is found.

The attributes of head are:
id ID Optional The identifier of the head. The
id attribute must be a valid
SGML identifier and must be
unique within the document.
version CDATA Optional The version of this element. By
default, the version of the head
is the same as the version of
the document (sdldoc) unless
that version has been overridden
by a version attribute in the
virtual page (virpage), form or
block containing the head.
class label Optional The class of a head describes
the general purpose
head the head is filling. The class
attribute is used
caption in conjunction with the level of
the object
annotation containing the head and ssi
attributes
phead to perform a lookup in the table
of semantics
udefhead and styles (toss) element. The
result of that lookup is
formatting and semantic
information pertaining to the
head.
language CDATA Optional The language in which this head
was written.
charset CDATA Optional The character set of this head.
The language and charset
attributes plus information
retrieved from the table of
semantics and styles (toss)
element are used to select the
font for the head.
type literal Optional Head text may be either
unformatted or preformatted.
lined By default, paragraph text is
assumed to be dynamic
(unformatted)
dynamic and all white space (space, tab,

Page 20 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

newline, etc.) may be replaced
with a single space. The type
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.
abbrev CDATA Optional An abbreviation allows simple
and/or short text to be
associated with a head element.
This text may be used in
situations where rich text is
inappropriate or where the head
is too long to use.
ssi CDATA Optional 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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.

SUBHEAD
Purpose
Alternate or additional headings, labels or captions.

<!ATTLIST subhead id ID #IMPLIED
version CDATA #IMPLIED
class (label |
head |
caption |

Page 21 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

annotation |
phead |
udefhead ) #IMPLIED
language CDATA #IMPLIED
charset CDATA #IMPLIED
type (literal |
lined |
dynamic ) #IMPLIED
abbrev CDATA #IMPLIED
ssi CDATA #IMPLIED >

DESCRIPTION
Subheads are simply one or more phrase-like elements that
further refine the main head.

The attributes of subhead are:
id ID Optional The identifier of the subhead.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
version CDATA Optional The version of this element. By
default, the version of the
subhead is the same as the
version of the document (sdldoc)
unless that version has been
overridden by a version
attribute in the virtual page
(virpage), form, block or head
containing the subhead.
class label Optional The class of a subhead describes
the general
head purpose the subhead is filling.
The class attribute
caption is used in conjunction with the
level of the object
annotation containing the head to which the
subhead belongs and ssi
phead attributes to perform a lookup
in the table of semantics
udefhead and styles (toss) element. The
result of that lookup is
formatting and semantic
information pertaining to the
subhead.
language CDATA Optional The language in which this
subhead was written.
charset CDATA Optional The character set of this
subhead. The language and
charset attributes plus
information retrieved from the

Page 22 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

table of semantics and styles
(toss) element are used to
select the subhead font.
type literal Optional Subhead text may be either
unformatted or preformatted.
lined By default, subhead text is
assumed to be dynamic
(unformatted)
dynamic and all white space (space, tab,
newline, etc.) may be replaced
with a single space. The type
attribute is used when the
author needs to represent
information that is at least
partially layout-sensitive.
Newline characters are
significant in lined subheads
and all whitespace is
significant in literal subheads.
abbrev CDATA Optional An abbreviation allows simple
and/or short text to be
associated with a subhead
element. This text may be used
in situations where rich text is
inappropriate or where the
subhead is too long to use.
ssi CDATA Optional 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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.

ATOMIC LINK ELEMENTS
ANCHOR
Purpose
To give an ID to a point in the document.

Page 23 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

SYNOPSIS
<!ELEMENT anchor - O EMPTY >
<!ATTLIST anchor id ID #REQUIRED >

DESCRIPTION
The anchor element provides a mechanism for assigning an ID
to an arbitrary spot in the document. An anchor may occur
anywhere that running text is allowed. This includes as
content of paragraphs (p) and heads (head and subhead).

The attribute of anchor is:
id ID Required The identifier of the anchor.
The id attribute must be a valid
SGML identifier and must be
unique within the document.

LINK
Purpose
A hyperlink within or outside the current document.

<!ATTLIST link rid IDREF
button IDREF
linkinfo CDATA
descript CDATA
window (current |
new |
popup )
traversal (return |
noreturn )

DESCRIPTION
A link element is the start point of a hyperlink to another
spot in the document or, via the system notation block
(snb), to another document or active hyperlink. The active
hyperlinks are sys-cmd and callback. These hyperlinks
(covered later in this document) are used to execute an
operating system command or to initiate a callback to the
application respectively.

A link may surround any text in the document, including text
found in paragraphs or heads, with the only exception being
that link elements may not contain other link elements.

The attributes of link are:

Page 24 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

rid IDREF Required 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
(snb) of the current virtual
page (virpage) to allow
reference to external objects or
actions.
button IDREF Optional 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 button attribute must be the
identifier of a graphic (covered
later in this document) in the
system notation block (snb) of
the current virtual page
(virpage). The graphic
referenced must have a class
attribute of button.
linkinfo CDATA Optional Information about the target of
the link. This information may
be displayed as part of a dialog
with the reader before
traversing the link if such
traversal is in some way
expensive in time.
descript CDATA Optional A general description of the
action that takes place when the
hyperlink is activated.
window current Optional By default, hyperlinking to
another location in
new this document or (via
indirection) externally,
popup is done by changing the view in
the current window or display
area. Specifying new for the
window attribute causes a new
window or display area to be
created for displaying hyperlink
target. Specifying popup for
this attribute causes the new
window or display area to be
lighter weight, if possible.
Often, popup windows are modal
and temporary.
By default, the current document
and location

Page 25 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

traversal return Optional

Page 26 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

noreturn in the document are stored on a
push down stack to allow
backtracking of hyperlinks. If
this attribute is specified as
noreturn, the current location
is forgotten on execution of the
link.

SNREF
Purpose
Reference to an element or alternates in the system notation
block (snb).

SYNOPSIS
<!ELEMENT snref - - (refitem+, alttext?) >
<!ATTLIST snref id ID #IMPLIED >

DESCRIPTION
A system notation reference (snref) 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 snref. The snref element references graphic and script
elements, both of which are covered later in this document.

An snref element consists of one or more refitem elements
followed by optional alternate text. Each refitem 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, alttext, which is very simple character data, is
displayed instead.

The attribute of snref is:
id ID Optional The identifier of the snref.
The id attribute must be a valid
SGML identifier and must be
unique within the document.

REFITEM
Purpose
A reference to an element in a system notation block.

Page 27 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
A reference item (refitem) is a single reference to an
element in the system notation block (snb) of the current
virtual page (virpage).

An snref consists of one or more refitem elements allowing
alternate choices for the item to be displayed. The refitem
elements are tried in turn in the order listed until one can
be successfully formatted and displayed. A refitem can
refer to a text element in the snb to allow a text
alternative for the referenced item.

A refitem has zero or more head elements, which may serve,
for example, as the caption of a graphic.

The attributes of refitem are:
rid IDREF Required The identifier of the item being
referenced in the system
notation block of the current
virtual page.
class figure Required The class of a refitem describes
the general purpose
in-line the refitem is filling. The
class attribute is
button used in conjunction with the
level of the enclosing
icon block, form or virpage and ssi
attributes to
udefgraph perform a lookup in the table of
semantics
table and styles (toss) element. The
result of that
cell lookup is formatting and
semantic information
list pertaining to the refitem.
button IDREFrmt Optional An optional reference to a
graphic of class button in the
snb of the current virpage.
This button may be used to
request refitem display on
systems where display of the

Page 28 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

item is slow or expensive in
some other way. That is, the
button is displayed and the
refitem is only displayed when
the button is activated.
ssi CDATA Optional 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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.

ALTTEXT
Purpose
Simple text alternative for snref.

SYNOPSIS
<!ELEMENT alttext - - CDATA >

DESCRIPTION
The alttext element is a place to put simple text for use if
all alternatives, including text replacements, from the list
of refitem elements in an snref fail to format.

The alttext element has no attributes.

ATOMIC TEXT ELEMENTS
REV
Purpose
Add change bars to displayed text.

DESCRIPTION
Surrounding data with a rev element signals to the formatter
that the surrounded data should be marked somehow as having

Page 29 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

undergone change. Typically, this mark is change bars on
the side of the data. An empty rev element implies some
text has been deleted.

The rev element has no attributes.

KEY
Purpose
Effect a change in font.

DESCRIPTION
Key phrases are data that are key to understanding the
paragraph in which they exist; that is, they have a special
significance. The key element is used to call readers'
attention to a particular phrase. The key element exists
only within the context of a paragraph (p); it is document
sub-structure.

The semantics of the key element have value to both
rendering and navigation. When rendered, the phrase is
highlighted, typically using a different font style or
attribute. In navigation, key data can be used as fields in
semantic searches or as variables in a relevance-ranking
algorithm.

There are an infinite variety of key phrases possible in
source documents. To assure that the delivery system can
fully use the semantics of key data, this delivery format
forces the semantic to be normalized. Each phrase is
required to have a class attribute as well as an optional
source semantic identifier (ssi).

Page 30 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

The intended uses for the possible key classes are:

acro An acronym.

book The proper title of a document.

emph An emphasized phrase.

jargon A phrase with application unique
significance; its definition is commonly
understood by convention by the
practitioner of the application field.

l10n A phrase that must be specially treated
during localization.

name A proper name.

quote A direct quote.

product A proper product name.

pub-lit A literal phrase added by the publisher.

termdef A phrase defined within the current
paragraph.

term A phrase defined elsewhere.

mach-in A machine input phrase.

mach-out A machine output phrase.

mach-cont A machine control or keyboard key name.

udefkey A user-defined key; this may be used by
the author of a higher level DTD to SDL
translator for unforeseen key phrases.

The attributes of key are:
charset CDATA Optional The character set of this key.
The language of the enclosing
paragraph (p) and charset
attributes plus information
retrieved from the table of
semantics and styles (toss)
element are used to select the
font for the key.
class acro Required See above.
book

Page 31 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

ssi CDATAeynt Optional 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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.

SPHRASE
Purpose
A super or sub-scripted phrase

SYNOPSIS
<!ELEMENT sphrase - - CDATA >
<!ATTLIST sphrase class (super |
sub ) #REQUIRED
ssi CDATA #IMPLIED >

DESCRIPTION
The stylized phrase (sphrase) contains stylized text. The
phrases are only presentationally significant. Two types
are supported, sub and super.

The attributes of sphrase are:
style super Required Indicates whether the sphrase
should be set in
sub superscript or subscript.
ssi CDATA Optional 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

Page 32 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.

SPC
Purpose
A special character.

SYNOPSIS
<!ELEMENT spc - O EMPTY >
<!ATTLIST spc name CDATA #REQUIRED >

DESCRIPTION
The spc 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.

The attribute of spc is:
name CDATA Required 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).

CONDITIONAL TEXT ELEMENTS
IF
Purpose
Conditional inclusion of text or data.

SYNOPSIS
<!ELEMENT if - - (cond, then, else?) >

DESCRIPTION
The if element allows conditional inclusion of other text
and data elements.

Page 33 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

The if element consists of a condition (cond) followed by a
then clause and an optional else clause. Based on the
result of the condition, either the then clause or the else
clause is included in the document. If the condition is
false and no else clause exists, the if element is
considered to be empty.

The if element has no attributes.

COND
Purpose
Boolean condition for the if element.

SYNOPSIS
<!ELEMENT cond - - CDATA >
<!ATTLIST cond interp NOTATION
(tcl |
sh |
ksh |
csh ) #IMPLIED >

DESCRIPTION
The cond element contains a script to be run by the
interpreter specified in the interp attribute. The CDATA
content of cond is passed to the interp. The return value
from the interpreter should be numeric.

The attribute of cond is:
interp NOTATION - Optional The interpreter to which to pass
the CDATA content
tcl of the cond element. It is
expected that the interpreter
sh returns a numeric string value.
One of the listed
ksh interpreters is often embedded
in the application
csh 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.

THEN
Purpose
Included text when the condition (cond) of the if element is
a non-zero string.

Page 34 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The then element contains text and data to be included if
the return value of the interpreter in the cond element is a
non-zero string. The then element may contain a nested if
element as well as any other text or data acceptable in a
paragraph (p).

The then element has no attributes.

ELSE
Purpose
Included text when the condition (cond) of the if element is
a string evaluating to zero.

DESCRIPTION
The else element contains text and data to be included if
the return value of the interpreter in the cond element is a
string evaluating to zero. The else element may contain a
nested if element as well as any other text or data
acceptable in a paragraph (p).

The else element has no attributes.

Notation Elements
GRAPHIC
Purpose
Attachment to a graphic image external to the current
document.

SYNOPSIS
<!ELEMENT graphic - O EMPTY >
<!ATTLIST graphic id ID #REQUIRED
format CDATA #IMPLIED
method IDREF #IMPLIED
xid CDATA #REQUIRED >

DESCRIPTION
The graphic element allows incorporation of graphic images
into an SDL-conforming document. Only one graphic type
element is declared; the class attribute is used to
distinguish between figure, in-line or button. A graphic
image is incorporated by putting an snref element in the
document at the point of inclusion. The rid attribute of
the snref should refer to the graphic element describing the
storage location and format of the image.

The attributes of graphic are:

Page 35 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

id ID Required The identifier of the graphic.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
format CDATA Required The format in which the graphic
is stored. Example values for
the format attribute are: tiff,
xpm, xbm and xwd.
method IDREF Optional A reference to a script element
(discussed later) in the system
notation block of the current
virtual page. The script in the
script element provides a
mechanism for performing any
setup necessary to display the
graphic image.
xid CDATA Required An external identifier for the
graphic image.

TEXT
Purpose
Alternate rich text for snref.

SYNOPSIS
<!ELEMENT text - - ((p | cp)*) >
<!ATTLIST text id ID #REQUIRED
language CDATA #REQUIRED
charset CDATA #IMPLIED >

DESCRIPTION
The text element allows for rich text alternatives to other
elements in the system notation block being referenced by
refitem elements in snref. A text element contains zero or
more paragraphs (p) or character paragraphs (cp).

The attributes of text are:
id ID Required The identifier of the text. The
id attribute must be a valid
SGML identifier and must be
unique within the document.
language CDATA Optional The language in which this text
was written.
charset CDATA Optional The character set of this text.
The language and charset
attributes plus information
retrieved from the table of
semantics and styles (toss)
element are used to select the
text font.

AUDIO
Purpose

Page 36 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

Attachment to an audio snippet external to the current
document.

SYNOPSIS
<!ELEMENT audio - O EMPTY >
<!ATTLIST audio id ID #REQUIRED
format CDATA #IMPLIED
method IDREF #IMPLIED
xid CDATA #REQUIRED >

DESCRIPTION
The audio element allows an audio snippet to be incorporated
into an SDL-conforming document. An audio snippet is
incorporated by putting an snref element in the document at
the point of inclusion. The rid attribute of the snref
should refer to the audio element describing the storage
location and format of the audio snippet.

The attributes of audio are:
id ID Required The identifier of the audio.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
format CDATA Required The format in which the audio
snippet is stored.
method IDREF Optional A reference to a script element
(covered later in this document)
in the system notation block of
the current virtual page. The
script in the script element
provides a mechanism for
performing any setup necessary
to present the audio snippet.
xid CDATA Required An external identifier for the
audio snippet.

VIDEO
Purpose
Attachment to a video clip external to the current document.

SYNOPSIS
<!ELEMENT video - O EMPTY >
<!ATTLIST video id ID #REQUIRED
format CDATA #IMPLIED
method IDREF #IMPLIED
xid CDATA #REQUIRED >

DESCRIPTION
The video element allows a video clip to be incorporated
into an SDL-conforming document. A video clip is
incorporated by putting an snref element in the document at
the point of inclusion. The rid attribute of the snref

Page 37 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

should refer to the video element describing the storage
location and format of the video clip.

The attributes of video are:
id ID Required The identifier of the video.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
format CDATA Required The format in which the video
clip is stored.
method IDREF Optional A reference to a script element
(covered later in this document)
in the system notation block of
the current virtual page. The
script in the script element
provides a mechanism for
performing any setup necessary
to present the video clip.
xid CDATA Required An external identifier for the
video clip.

ANIMATE
Purpose
Attachment to an animation sequence external to the current
document.

SYNOPSIS
<!ELEMENT animate - O EMPTY >
<!ATTLIST animate id ID #REQUIRED
format CDATA #IMPLIED
method IDREF #IMPLIED
xid CDATA #REQUIRED >

DESCRIPTION
The animate element allows an animation sequence to be
incorporated into an SDL-conforming document. An animation
sequence is incorporated by putting an snref element in the
document at the point of inclusion. The rid attribute of
the snref should refer to the animate element describing the
storage location and format of the animation sequence.

The attributes of animate are:
id ID Required The identifier of the animate.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
format CDATA Required The format in which the
animation sequence is stored.
method IDREF Optional A reference to a script element
(covered later in this document)

Page 38 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

in the system notation block of
the current virtual page. The
script in the script element
provides a mechanism for
performing any setup necessary
to present the animation
sequence.
xid CDATA Required An external identifier for the
animation sequence.

SCRIPT
Purpose
Data collection and/or generation of dynamic text.

SYNOPSIS
<!ELEMENT script - - CDATA >
<!ATTLIST script id ID #REQUIRED
interp NOTATION
(tcl |
sh |
ksh |
csh ) #IMPLIED >

DESCRIPTION
The script element is the mechanism within SDL for
collecting usage data or generating dynamic (on-the-fly)
text. When referenced via an snref, the CDATA content of
the script element is passed to the designated interpreter.
If the return value from the interpreter is non-NULL, that
value is interpolated into the document at the point of the
snref. 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.

The attributes of script are:
id ID Required The identifier of the script.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
interp NOTATION - Optional The interpreter to which to pass
the CDATA
tcl content of the script element.
One of the
sh listed interpreters is often
embedded in the
ksh application and does notrequire
another process to
csh execute. If the specified
interpreter does not exist, the

Page 39 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

default return value is NULL.

CROSSDOC
Purpose
Indirect element for following a hyperlink outside the
current document.

SYNOPSIS
<!ELEMENT crossdoc - O EMPTY >
<!ATTLIST crossdoc id ID #REQUIRED
xid CDATA #REQUIRED >

DESCRIPTION
The crossdoc element is the mechanism within SDL for
effecting a hyperlink to an external document. To create an
external, cross-document hyperlink, a link to the crossdoc
is placed in the text. The crossdoc element contains the
necessary information to find the desired document and id
within that document.

The attributes of crossdoc are:
id ID Required The identifier of the crossdoc.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
xid CDATA Required An external identifier for the
external document and id.

MAN PAGE
Purpose
Indirect element for following a hyperlink to a reference
manual page.

SYNOPSIS
<!ELEMENT man-page - O EMPTY >
<!ELEMENT crossdoc - O EMPTY >
<!ATTLIST man-page id ID #REQUIRED
xid CDATA #REQUIRED >

DESCRIPTION
The man-page 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 link to the man-page is placed in the text.
The man-page element contains the necessary information to
find and display the desired manual page.

The attributes of man-page are:

Page 40 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

id ID Required The man-page identifier. The id
attribute must be a valid SGML
identifier and must be unique
within the document.
xid CDATA Required An external identifier for the
reference manual page.

TEXTFILE
Purpose
Indirect element for following a hyperlink to a text file.

SYNOPSIS
<!ELEMENT textfile - O EMPTY >
<!ATTLIST textfile id ID #REQUIRED
xid CDATA #REQUIRED >

DESCRIPTION
The textfile element is the mechanism within SDL for
effecting a hyperlink to (display of) a text file. To
create a text file hyperlink, a link to the textfile is
placed in the text. The textfile element contains the
necessary information to find the desired file.

The attributes of textfile are:
id ID Required The identifier of the textfile.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
xid CDATA Required An external identifier for the
text file.

SYS-CMD
Purpose
Indirect element for following a hyperlink to a system
command.

SYNOPSIS
<!ELEMENT sys-cmd - O EMPTY >
<!ATTLIST sys-cmd id ID #REQUIRED
xid CDATA #REQUIRED >

DESCRIPTION
The sys-cmd element is the mechanism within SDL for
effecting a hyperlink to (execution of) a system command.
To create a system command hyperlink, a link to the sys-cmd
is placed in the text. The sys-cmd element contains the
necessary information to find and execute the system
command.

The attributes of sys-cmd are:

Page 41 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

id ID Required The identifier of the sys-cmd.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
xid CDATA Required An external identifier for the
system command.

CALLBACK
Purpose
Indirect element for following a hyperlink into the
application.

SYNOPSIS
<!ELEMENT callback - O EMPTY >
<!ATTLIST callback id ID #REQUIRED
xid CDATA #REQUIRED >

DESCRIPTION
The callback element is the mechanism within SDL for
effecting a hyperlink into the enclosing application. To
create a application callback hyperlink, a link to the
callback is placed in the text. The callback element
contains the necessary information to inform the application
of the desired action.

The attributes of callback are:
id ID Required The identifier of the callback.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
xid CDATA Required An external identifier and user
data for the application
callback.

SWITCH
Purpose
Conditional hyperlink.

SYNOPSIS
<!ELEMENT switch - - CDATA >
<!ATTLIST switch id ID #REQUIRED
interp NOTATION
(tcl |
sh |
ksh |
csh )
branches IDREFS #REQUIRED >

DESCRIPTION
The switch element is part of the system notation block,
snb, and is always instantiated via a reference by a link
element. When activated by the hyperlink, the interpreter

Page 42 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

(interp) 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 branches 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 ids in the branches
attribute, will cause the hyperlink to continue to the first
branch in the list.

The attributes of switch are:
id ID Required The identifier of the switch.
The id attribute must be a valid
SGML identifier and must be
unique within the document.
interp NOTATION - Optional The interpreter to which to pass
the CDATA content
tcl of the switch element. It is
expected that the
sh interpreter returns a numeric
string value equal to
ksh or greater than zero. One of
the listed interpreters
csh 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.
branches IDREFS Required A list of IDs in the current
document. The return value of
the interp attribute is used to
index into this list of IDs and
the hyperlink is continued at
the resulting ID.

Generated Elements
REL-DOCS
Purpose
Documents related to this document.

SYNOPSIS
To be determined.

DESCRIPTION
To be determined.

REL-FILE
Purpose
Files related to this document.

Page 43 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

SYNOPSIS
To be determined.

DESCRIPTION
To be determined.

NOTES
Purpose
Notes related to this document.

SYNOPSIS
To be determined.

DESCRIPTION
To be determined.

LOIDS and ID
Purpose
List of identifiers in the document.

SYNOPSIS
<!ELEMENT loids
<!ATTLIST loids count NUMBER #IMPLIED >

Page 44 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The loids element is a container for a list of identifiers
in the document. The list appears in the order the
identifiers appear.

The loids element can be used to generate a table of
contents for the document by selecting only those elements
whose type is virpage and listing the heads of those virpage
elements. The rlevel attribute can be used to infer the
nesting level of the virpage and to avoid reading the head
of virtual pages whose nesting level is deeper than is
currently being displayed.

The attribute of loids is:
count NUMBER Optional The number of id elements
contained in the loids. This
attribute, if present, can be
used by the processor to pre-
allocate space for the id
elements.

The attributes of id are:
type virpage Required The name of the element to which
this id belongs.
rid IDREFack Required The referenced identifier.
rssi CDATA Optional The source semantic identifier
(ssi) of the element referenced
by the rid attribute.
rlevel NUMBER Optional The level of the element
referenced by the rid attribute.
This attribute defaults to 1.
offset NUMBER Required The byte offset in the document
to the start of the virtual page
containing the element
referenced by the rid attribute.

INDEX and ENTRY
Purpose
Contains the index for the document.

SYNOPSIS
<!ELEMENT index - - (entry*) >
<!ATTLIST index head CDATA #IMPLIED
count NUMBER #IMPLIED >

<!ELEMENT entry ((key | sphrase | rev | if | spc | snref | #PCDATA)*, entry*) >

Page 45 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

<!ATTLIST entry id ID #IMPLIED
main IDREFS #IMPLIED
locs IDREFS #IMPLIED
syns IDREFS #IMPLIED
sort CDATA #IMPLIED >

DESCRIPTION
The index 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.

The index can be used to enable keyword searches within a
document.

An index consists of zero or more entries.

The attributes of index are:
head CDATA Optional Alternate text for the heading
of the index.
count NUMBER Optional The number of entry elements
contained in the index. The
processor cn use this attribute
(if this attribute is present)
to pre-allocate space for the
entry elements.

The attributes of entry are:
id ID Optional The identifier of the index
entry.
main IDREFS Optional 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 locs
list.
locs IDREFS Optional A list of identifiers specifying
where the indexed entry may be
found. At least one of either
main or locs must be specified.
syns IDREFS Optional A list of identifiers that refer
to other entry elements and
correspond to a ``See also'' or
synonym-type of reference.
sort CDATA Optional A sort key to use if the indexed
entry is to be sorted other than
by its content.

LOPHRASES
Purpose

Page 46 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

A list of semantic phrases used in this document.

SYNOPSIS
<!ELEMENT lophrases - - (phrase+) >
<!ATTLIST lophrases count NUMBER #IMPLIED >

DESCRIPTION
The list of phrases (lophrases) element is generated by the
higher level DTD to SDL translator. It is a list of phrases
used from the toss 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.

The lophrases element differs from the phrases in the toss
in that the toss contains all phrases possible in a higher
level DTD to SDL translation and the lophrases element
contains only those used in the translation of this
particular document.

The attribute of lophrases is:
count NUMBER Optional The number of phrase elements
contained in the lophrases. The
processor can use this attribute
(if this attribute is present)
to pre-allocate space for the
phrase elements.

PHRASE
Purpose
A single phrase in the lophrases element.

SYNOPSIS
<!ELEMENT phrase - O EMPTY >
<!ATTLIST phrase text CDATA #REQUIRED >

DESCRIPTION
The phrase element is a single phrase from the list of
phrases element (lophrases).

The attribute of phrase is:
text CDATA Required The semantic phrase.

TOSS
Purpose
The table of semantics and styles.

SYNOPSIS
<!ELEMENT toss - - (keystyle*, headstyle*, frmtstyle*, grphstyle*)>

Page 47 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The toss element is a container for the table of semantics
and styles. Each sub-element of the toss represents a
different formatting group. These sub-elements also contain
class and ssi (source semantic identifier) attributes to
allow general and specific semantic or structured searches.
A phrase attribute of many of the toss 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.

Lookups in the toss are done by matching the class and ssi
attributes of the element in the document proper with the
class and ssi attributes of the sub-element of the toss.
The lookup can often be further refined by matching the
level attribute (if present) of the element in the document
with the rlevel attribute (if present) in the sub-element of
the toss.

Structured searches based on the structure of a domain-
specific higher level DTD can be made by having the ssi
attribute of the sub-element directly correspond to the
generic identifier from the original DTD.

The attribute of toss is:
count NUMBER Optional The number of styles contained
in the toss. The processor can
use this attribute (if this
attribute is present) to pre-
allocate space for the styles.

KEYSTYLE
Purpose
Provides font and semantic information for key phrases.

Page 48 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

pub-lit |
udefkey ) #REQUIRED
ssi CDATA #IMPLIED
rlevel NUMBER #IMPLIED
phrase CDATA #IMPLIED
srch-wt NUMBER #IMPLIED
pointsz NUMBER #IMPLIED
set-width NUMBER #IMPLIED
color CDATA #IMPLIED
xlfd CDATA #IMPLIED
xldfi CDATA #IMPLIED
xlfdb CDATA #IMPLIED
xlfdib CDATA #IMPLIED
typenam CDATA #IMPLIED
typenami CDATA #IMPLIED
typenamb CDATA #IMPLIED
typenamib CDATA #IMPLIED
style (serif |
sans-serif |
symbol ) #IMPLIED
spacing (monospace |
propspace ) #IMPLIED
weight (medium |
bold ) #IMPLIED
slant (roman |
italic |
rev-italic | #IMPLIED
special (underline |
strikeout |
none ) #IMPLIED >

DESCRIPTION
The keystyle element provides semantic and font information
for key phrases in the document.

When a key element is encountered in the document, the toss
list of keystyle elements is ssearched with an attempt made
to match the class and ssi (if any) attributes of the key
element to the class and ssi (if any) attributes of the
keystyle. If the keystyle specifies an rlevel attribute,
the search is further refined by matching the level of the
block containing the paragraph (p) to the rlevel of the
keystyle. If the key element has no ssi attribute, the
search in the toss looks for a keystyle element with no ssi
specified. A keystyle element with no ssi specified matches
any ssi in a key element although an explicit class/ssi pair
is chosen in preference.

When a match is found, the font information contained in the
keystyle is used in formatting the key element.

The attributes of keystyle are:

Page 49 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

class acro Required The general type of the key
element in the
book document.
ssi CDATAeynt Optional 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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.
rlevel NUMBER Optional Used to further refine matches
of the class and ssi attributes.
If present, the rlevel of the
keystyle is matched against the
level of the block containing
the paragraph (p) containing the
key element.
phrase CDATA Optional A natural language phrase
describing the semantics
(meaning) of the element in the
original SGML document that was
translated into this key. This
phrase can be used to present an
interface to the reader for
searching or otherwise examining
the document.
srch-wt NUMBER Optional 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.
pointsz NUMBER Optional The height of the font in
points. By default, the main
body of the document is 10
point.
set-width NUMBER Optional The width of the font in points;

Page 50 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

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.
color CDATA Optional One of the 42 common desktop
environment (CDE) colors or
RGB:rrrr/gggg/bbbb.
xlfd CDATA Optional These attributes should always
be specified as
xlfdi a group. They are X logical
font descriptions
xlfdb (XLFD) typeface names for use on
the X
xlfdib 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
(style, spacing, weight, slant)
are given.
typenam CDATA Optional These attributes should always
be specified as a group.
typenami They are the MS-Windows typeface
name with a maximum
typenamb of 32 characters. There is one
specification each
typenamib 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.
style serif Optional The font style.
spacing monospacef Optional Specifies fixed versus
proportional spacing.
weight mediumace Optional Specifies normal versus bold
font.
slant roman Optional Specifies Roman, italic or
reverse italic font.
rev-italic Special attribute of the font.
The underline value is

Page 51 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

special underline Optional

Page 52 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

strikeout interpreted as appropriate for
the font.
none Some non-European fonts use
overlining for the purpose
filled by underlining in
European fonts.

HEADSTYLE
Purpose
Provides formatting, font and semantic information for
headings (head and subhead).

SYNOPSIS
<!ELEMENT headstyle - O EMPTY >
<!ATTLIST headstyle class (label |
head |
caption |
undefhead ) #REQUIRED
ssi CDATA #IMPLIED
rlevel NUMBER #IMPLIED
phrase CDATA #IMPLIED
srch-wt CDATA #IMPLIED
orient (left-orient |
center-orient |
right-orient |
left-corner-orient |
right-corner-orient )
vorient (top-vorient |
bottom-vorient |
center-vorient ) #IMPLIED
placement (object |
parent ) #IMPLIED
headw CDATA #IMPLIED
stack (horiz |
vert ) #IMPLIED
flow (wrap |
nowrap ) #IMPLIED
phrase CDATA #IMPLIED
srch-wt NUMBER #IMPLIED
pointsz NUMBER #IMPLIED
set-width NUMBER #IMPLIED
color CDATA #IMPLIED
xlfd CDATA #IMPLIED
xldfi CDATA #IMPLIED
xlfdb CDATA #IMPLIED
xlfdib CDATA #IMPLIED
typenam CDATA #IMPLIED
typenami CDATA #IMPLIED
typenamb CDATA #IMPLIED
typenamib CDATA #IMPLIED

Page 53 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The headstyle element provides semantic, font and formatting
information for headings (head and subhead) in the document.

When a heading is encountered in the document and that
heading has an ssi attribute, the toss list of headstyle
elements is searched with an attempt made to match the class
and ssi attributes of the heading to the class and ssi
attributes of the headstyle. If the headstyle specifies an
rlevel attribute, the search is further refined by matching
the level of the element containing the heading to the
rlevel of the headstyle. If the element containing the
heading does not have a level attribute, the level of its
containing element is used, and so on. A headstyle element
with no ssi specified matches any ssi in a head element
although an explicit class/ssi pair is chosen in preference.

When a match is found, the font and style information

Page 54 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

contained in the headstyle is used in formatting the
heading.

The attributes of headstyle are:
class label Required The general type of the heading
in the document.
ssi CDATAeadon Optional 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
ssi may be used to enable
structured searches of the SDL-
conforming document by
preserving the original generic
identifiers.
rlevel NUMBER Optional Used to further refine matches
of the class and ssi attributes.
If present, the rlevel of the
headstyle is matched against the
level of the element containing
the heading or, if none, the
level of the first containing
element with a level attribute.
phrase CDATA Optional 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.
srch-wt NUMBER Optional A number indicating the
likelihood that this element
contains an actual hit when
doing a full-text search.
srch-wt NUMBER Optional A number indicating the

Page 55 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

likelihood that this element
contains an actual hit when
doing a full-text search.
orient left-orient Optional The horizontal orientation of
the head with respect
center-orient to its associated element or of
the subhead with
right-orient respect to its head. The
default is center-orient.
left-margin-orient This value is used in
conjunction with the vorient
right-margin-orient attribute to orient the heading.
The corner orientations
left-corner-orient are to place the heading in one
of the four corners
right-corner-orient 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.
vorient top-vorient Optional The vertical orientation of the
head with respect to its
bottom-vorient associated element or of the
subhead with respect to
center-vorient its head. The default is top-
vorient.
placement object Optional This attribute applies only to
head elements.
parent This attribute indicates whether
the orient and vorient
attributes apply to the head
proper or to the entire head
object, including all its
subhead elements. This
attribute should default to
parent.
headw CDATA Optional The percentage of the available
space for the current element
that should be given to its head
or the percentage of the head

Page 56 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

that should be given to its
subhead. 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.
stack horiz Optional Where to put this head or
subhead if it collides
vert 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.
flow wrap Optional Specifies whether the text of
the containing element
nowrap should flow around the heading
or
join not. The default is no-wrap. A
flow 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.
pointsz NUMBER Optional The height of the font in
points. By default, the main
body of the document is 10
point.
set-width NUMBER Optional 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.
color CDATA Optional One of the 42 CDE colors or
RGB:rrrr/gggg/bbbb.
xlfd CDATA Optional These attributes should always
be specified as a group.
xlfdi They are X logical font
description (XLFD) typeface
xlfdb names for use on the X Window
System. Specified,
xlfdib for example, as ``-adobe-
helvetica-bold-i-narrow-*-''.
The four specifications are for
normal, italic, bold and bold-
italic. This attribute should

Page 57 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

only be specified if the author
is sure of the desired font. In
the usual case, only the logical
typeface specifications (style,
spacing, weight, slant) is
given.
typenam CDATA Optional These attributes should always
be specified as a group.
typenami They are the MS-Windows typeface
name with a maximum of
typenamb 32 characters. There is one
specification each for
typenamib 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.
style serif Optional The font style.
spacing monospacef Optional Specifies fixed versus
proportional spacing.
weight mediumace Optional Specifies normal versus bold
font.
slant roman Optional Specifies Roman, italic or
reverse italic font.
special underlinec Optional Special attribute of the font.
The underline value is
strikeout interpreted as appropriate for
the font.
none Some non-European fonts use
overlining for the purpose
filled by underlining in
European fonts.
f-margin CDATA Optional 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.
l-margin NUMBER Optional 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

Page 58 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

zero.
r-margin NUMBER Optional 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.
t-margin NUMBER Optional 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.
b-margin NUMBER Optional 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.
border no-border Optional Specifies the decoration type.
The default is no-border.
justify left-justifyrerer Optional Horizontal justification of the
text or data.
right-justify The default is left-justify.
The numeric-justify
center-justify value implies alignment of
decimal points.
vjust top-vjustustify Optional The alignment of the head or
subhead
bottom-vjust in the space carved out by the
largest head
center-vjust or subhead in the same plane.
That is, should this head or
subhead be aligned with the top
of the largest related head or

Page 59 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

subhead, the bottom, or the
center. In general, the vjust
attribute may be seen as
justifying text vertically. If
a head or subhead is being
placed alongside another head or
subhead 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 vjust attribute justifies
the text within that length.

FORMSTYLE
Purpose
Provides formatting, font and semantic information for form
elements.

SYNOPSIS
<!ELEMENT formstyle - O EMPTY >
<!ATTLIST formstyle (class table |
list |
text |
udeffrmt ) #REQUIRED
ssi CDATA #IMPLIED
rlevel NUMBER #IMPLIED
phrase CDATA #IMPLIED
srch-w CDATA #IMPLIED
phrase CDATA #IMPLIED
srch-wt NUMBER #IMPLIED
pointsz NUMBER #IMPLIED
set-width NUMBER #IMPLIED
color CDATA #IMPLIED
xlfd CDATA #IMPLIED
xldfi CDATA #IMPLIED
xlfdb CDATA #IMPLIED
xlfdib CDATA #IMPLIED
typenam CDATA #IMPLIED
typenami CDATA #IMPLIED
typenamb CDATA #IMPLIED
typenamib CDATA #IMPLIED
style (serif |
sans-serif |
symbol ) #IMPLIED
spacing (monospace |
propspace ) #IMPLIED
weight (medium |
bold ) #IMPLIED
slant (roman |

Page 60 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The formstyle element provides semantic, font and formatting
information for form elements.

When a form element is encountered in the document and that
element has an ssi attribute, the toss list of formstyle
elements is searched with an attempt made to match the class
and ssi attributes of the element to the class and ssi
attributes of the formstyle. If the formstyle specifies an
rlevel attribute, the search is further refined by matching
the nesting level of the form to the rlevel of the
formstyle. A formstyle element with no ssi specified,
matches any ssi in a form, although an explicit class/ssi
pair is chosen in preference.

When a match is found, the font and style information
contained in the formstyle is used in formatting the
element.

The attributes of formstyle are:
class table Required The general function of the form
in the document.
ssi CDATArmt Optional 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

Page 61 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.
rlevel NUMBER Optional Used to further refine matches
of the class and ssi attributes.
If present, the rlevel of the
formstyle is matched against the
nesting level of the form being
formatted.
phrase CDATA Optional A natural language phrase
describing the semantics
(meaning) of the element in the
original SGML document that was
translated into this form. This
phrase can be used to present an
interface to the reader for
searching or otherwise examining
the document.
srch-wt NUMBER Optional A number indicating the
likelihood that this element
contains an actual hit when
doing a full-text search.
colw CDATA Optional Column widths. One
specification for each column in
the form. 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

Page 62 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

(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

Page 63 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

colj CDATA Optional Thetcolumn justification.isTthe
defaultijustificationxapplied to
eachlcelldinutheocolumn.ThThis
attributemiseaclistnofoncols
letters chosenIfrom:c``l,''the
``r,'' ``c,''dandi``d.''y Thesey
letters specify left,rright,
centeredsandidecimal greater
justification, respectively.the
Thislattributerdefaultsoto, the
``l.''specifications are
pointsz NUMBER Optional TheoheightIoftthenfontrinf
points. sBycdefault, thesmainn
bodynoflthetdocument ise10inal
point.ication is replicated to
set-width NUMBER Optional Theewidth oftthe fonteinopoints;
theudefault 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.
color CDATA Optional One of the 42 common desktop
environment (CDE) colors or
RGB:rrrr/gggg/bbbb.
xlfd CDATA Optional These attributes should always
be
xlfdi specified as a group. They are
X logical
xlfdb font descriptions (XLFD)
typeface names
xlfdib 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 (style, spacing,
weight, slant) is given.
typenam CDATA Optional These attributes should always
be specified as a group.
typenami a maximum of 32 characters.
There is one specification
typenamib each for normal, italic, bold
and bold-italic. These

Page 64 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

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.
style serif Optional The font style.
spacing monospacef Optional Specifies fixed versus
proportional spacing.
weight mediumace Optional Specifies normal versus bold
font.
slant roman Optional Specifies Roman, italic or
reverse italic font.
special underlinec Optional Special attribute of the font.
The underline value is
italic interpreted as appropriate for
the font.
rev-italic Some non-European fonts use
overlining for
strikeout the purpose filled by
underlining in European fonts.
l-margin NUMBER Optional 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.
r-margin NUMBER Optional 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.
t-margin NUMBER Optional 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

Page 65 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

line height and defaults to
zero.
b-margin NUMBER Optional 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.
border no-border Optional Specifies the decoration type.
no-border The default is no-border.
vjust top-vjustderrerer Optional Vertical justification of the
text of this
bottom-vjust element. The default is top-
vjust.
center-vjust
FRMTSTYLE
Purpose
Provides formatting, font and semantic information for
virpage, block and p elements.

SYNOPSIS
<!ELEMENT frmtstyle - O EMPTY >

<!ATTLIST frmtstyle (class table |
list |
text |
udeffrmt ) #REQUIRED
ssi CDATA #IMPLIED
rlevel NUMBER #IMPLIED
phrase CDATA #IMPLIED
srch-wt CDATA #IMPLIED
phrase CDATA #IMPLIED
srch-wt NUMBER #IMPLIED
pointsz NUMBER #IMPLIED
set-width NUMBER #IMPLIED
color CDATA #IMPLIED
xlfd CDATA #IMPLIED
xldfi CDATA #IMPLIED
xlfdb CDATA #IMPLIED
xlfdib CDATA #IMPLIED
typenam CDATA #IMPLIED
typenami CDATA #IMPLIED
typenamb CDATA #IMPLIED
typenamib CDATA #IMPLIED
style (serif |

Page 66 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The frmtstyle element provides semantic, font and formatting
information for virpage, block and p elements.

When a one of the elements listed in the FRMSTYLE Synopsis
is encountered in the document and that element has an ssi
attribute, the toss list of frmtstyle elements is serached
with an attempt made to match the class and ssi attributes
of the element to the class and ssi attributes of the
frmtstyle. If the frmtstyle specifies an rlevel attribute,
the search is further refined by matching the level of the
element containing the element to the rlevel of the
frmtstyle. If the element does not have a level attribute,
the level of its containing element is used, and so on. A
frmtstyle element with no ssi specified matches any ssi in a
formattable element although an explicit class/ssi pair is
chosen in preference.

When a match is found, the font and style information

Page 67 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

contained in the frmtstyle is used in formatting the
element.

The attributes of frmtstyle are:
class table Required The general function of the
form.
cell in the document.
ssi CDATArmt Optional The general function of the
form. 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 ssi may
be used to enable structured
searches of the SDL-conforming
document by preserving the
original generic identifiers.
rlevel NUMBER Optional Used to further refine matches
of the class and ssi attributes.
If present, the rlevel of the
frmtstyle is matched against the
level of the element being
formatted or, if none, the level
of the first containing element
with a level attribute.
phrase CDATA Optional 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.
A number indicating the
likelihood that this element
contains an actual hit when
doing a full-text search.

Page 68 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

srch-wt NUMBER Optional

Page 69 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

pointsz NUMBER Optional The height of the font in
points. By default, the main
body of the document is 10
point.
set-width NUMBER Optional 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.
color CDATA Optional One of the 42 CDE colors or
RGB:rrrr/gggg/bbbb.
xlfd CDATA Optional These attributes should always
be specified as a group.
xlfdi They are X logical font
description (XLFD) typeface
xlfdb names for use on the X Window
System. Specified, for example,
xlfdib 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
(style, spacing, weight, slant)
are given.
typenam CDATA Optional These attributes should always
be specified as a group.
typenami They are the MS-Windows typeface
names
typenamb with a maximum of 32 characters.
There is one
typenamib 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 (style,
spacing, weight, slant) are
given.
style serif Optional The font style.
spacing monospacef Optional Specifies fixed versus
proportional spacing.
propspace

Page 70 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

weight medium Optional Specifies normal versus bold
font.
slant roman Optional Specifies Roman, italic or
reverse italic font.
special underlinec Optional Special attribute of the font.
The underline value is
interpreted
strikeout as appropriate for the font.
Some non-European
none fonts use overlining for the
purpose filled by underlining in
European fonts.
f-margin CDATA Optional 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.
l-margin NUMBER Optional 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.
r-margin NUMBER Optional 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.
t-margin NUMBER Optional 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

Page 71 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

is zero
b-margin NUMBER Optional 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
border no-border Optional Specifies the decoration type.
full-border The default is no-border.
vjust top-vjustderrerer Optional Vertical justification of the
text of
bottom-vjust this element. The default is
top-vjust.
justify left-justify Optional Horizontal justification of the
text or data.
right-justify The default is left-justify.
center-justify The numeric-justify value
implies alignment
numeric-justify of decimal points.

GRPHSTYLE
Purpose
Provides formatting and semantic information for refitem
elements with a class attribute value taken from the graphic
class.

SYNOPSIS
<!ELEMENT grphstyle - O EMPTY >

Page 72 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

DESCRIPTION
The grphstyle element provides semantic, font and formatting
information for refitem elements with a class attribute
taken from the graphic class.

When a one of the above elements is encountered in the
document and that element has an ssi attribute, the toss
list of grphstyle elements is searched with an attempt made
to match the class and ssi attributes of the element to the
class and ssi attributes of the grphstyle. If the grphstyle
specifies an rlevel attribute, the search is further refined
by matching the level of the element containing the element
to the rlevel of the grphstyle. The level of a refitem is
taken from the level of its enclosing block. If the
enclosing block does not have a level attribute, the level
of its enclosing virpage is used. A grphstyle element with
no ssi specified, matches any ssi in a refitem element,
although an explicit class/ssi pair is chosen in preference.

When a match is found, the style information contained in
the grphstyle is used in formatting the graphic.

The attributes of grphstyle are:
class figure Required The general function of the
graphic
in-line in the document.
ssi CDATArph Optional 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

Page 73 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

intent of the markup. When the
original markup was conforming
to a domain-specific DTD, the
ssi may be used to enable
structured searches of the SDL-
conforming document by
preserving the original generic
identifiers.
rlevel NUMBER Optional Used to further refine matches
of the class and ssi attributes.
If present, the rlevel of the
grphstyle is matched against the
level of the first containing
element with level attribute.
phrase CDATA Optional 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.
l-margin NUMBER Optional 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.
r-margin NUMBER Optional 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.
t-margin NUMBER Optional The top margin. This value
takes the maximum, that is, if
an element has a top margin and
is (logically) contained in

Page 74 (printed 9/3/04)

dtsdldtd(4) UNIX System V (1 August 1995) dtsdldtd(4)

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.
b-margin NUMBER Optional 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.
border no-border Optional Specifies the decoration type.
full-border The default is no-border.
vjust top-vjustderrerer Optional Vertical justification of the
graphic.
bottom-vjust The default is top-vjust.
justify left-justify Optional Horizontal justification of the
graphic.
right-justifyt The default is left-justify.
center-justify
SEE ALSO
DtCreateHelpDialog(3), DtCreateQuickHelpDialog(3).

Page 75 (printed 9/3/04)

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]

Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................

Vote for polarhome