Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dtsdldtd(other)						       dtsdldtd(other)

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  sys-
       tems 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 sdldoc
			    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:

       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  spe-
					      cific   to  this	version	  (in-
					      stance) 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 war-
					      rant a new  doc-id,   but	 might
					      need some	bookmark/annotation
					       cleanup or repair.
       first-page   IDREF	 Optional     If specified, the	first-page at-
					      tribute identifies the   virtual
					      page  to	display	upon first en-
					      tering 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  restric-
					      tions are	applied.
       language	    CDATA	 Optional     The default language of the doc-
					      ument. This
					       attribute may be	overridden  in
					      later  elements.	 The  language
					      attribute	and the	charset	attri-
					      bute   of	 elements  are used to
					      select the proper	font for  dis-
					      play.
       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  dis-
					      play.
       author	    CDATA	 Optional     The  source  author or publisher
					      of the document.
       version	    CDATA	 Optional     The default version of this doc-
					      ument.  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 ex-
					      ample, 1.0. A change in the  mi-
					      nor  version  number  implies  a
					      change that is backward compati-
					      ble, albeit with potentially re-
					      duced 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?,  in-
			     dex?,  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.	Gener-
       ated  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 el-
       ement  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 ele-
					    ment. By default, the  ver-
					    sion  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  be-
					    longs.

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
			       charset	   CDATA	#IMPLIED
			       doc-id	   CDATA	#REQUIRED
			       ssi	   CDATA	#IMPLIED >

DESCRIPTION
       The virtual page	( virpage) element is the smallest, directly  address-
       able  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  for-
       matting context.	Virtual	pages may be displayed and understood when re-
       moved from the context of the document as long as the table  of	seman-
       tics  and  styles  ( toss) element is available for formatting informa-
       tion.

       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  ex-
       ternal 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,  hy-
					 perlink to this id.
       level	  NUMBER     Required	 The  hierarchical  level  of the
					 information contained in the el-
					 ement.	The level attribute makes
					 explicit information that is im-
					 plicit	in typical  SGML conform-
					 ing documents.	 An SDL	 conform-
					 ing  document	may be considered
					 to have  been flattened to allow
					 direct	 access	of inferior  top-
					 ics. For example, if the  source
					 DTD  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, re-
					 spectively.
       version	  CDATA	     Optional	 The version of	this element.  By
					 default, the version of the vir-
					 page is the same as the  version
					 of
					  the document (sdldoc).
       language	  CDATA	     Optional	 The  language in which	this ele-
					 ment is written.  This	attribute
					 may  be  overridden individually
					 within	the form and  block  ele-
					 ments	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 con-
					 tained	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 transla-
					 tor.  It may either  reflect the
					 meaning of  the  markup  in  the
					 original   document  or  may re-
					 flect the actual generic identi-
					 fier  in  the original	document.
					 The source  semantic  identifier
					 may be	used to	 assist	in seman-
					 tic searches of the SDL conform-
					 ing  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 en-
					 able structured searches of  the
					 SDL  conforming document by pre-
					 serving  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.

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

SYNOPSIS
       <!ELEMENT snb	-  -  (head?,  (graphic	 | text	| audio	|
			video |animate | crossdoc  |  man-page	|
			textfile  | sys-cmd | callback | script	|
			switch)+) >
       -----------------------------------------------------------

       <!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	struc-
       tural 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)*) >
       -----------------------------------------------------------

       <!ATTLIST block	    id	       ID		    #IMPLIED
			    level      NUMBER		    #IMPLIED
			    version    CDATA		    #IMPLIED
			    class      (table	    |
				       cell	    |
				       list	    |
				       item	    |
				       text	    |
				       udeffrmt	    )	    #IMPLIED

			    language   CDATA		    #IMPLIED
			    charset    CDATA		    #IMPLIED
			    length     NUMBER		    #IMPLIED
			    app	       (all	    |
				       help	    |
				       tutorial	    |
				       ref	    |
				       sys	    )	    #IMPLIED
			    timing     (sync	    |
				       async	    )	    #IMPLIED
			    ssi	       CDATA		    #IMPLIED >

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  con-
       tain  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  pre-
       sentational  effect of nested blocks can	be achieved by using the level
       attribute.

       The structure of	a document includes blocks that	are part of the	 prin-
       cipal  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.  Al-
       ternate 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	refer-
       ence.

       The  level,  class and ssi attributes of	a block	can be used 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 in-
					 formation  contained  in the ele-
					 ment. The level  attribute  makes
					 explicit  information that is im-
					 plicit	in typical   SGML-conform-
					 ing documents.	 An SDL-conforming
					 document  may	be  considered	to
					 have	been  flattened	 with  im-
					 plicit	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)  contain-
					 ing 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) ele-
					 ment. The result of
		  udeffrmt		 that lookup is	formatting and se-
					 mantic	 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   at-
					 tributes   plus  information  re-
					 trieved from  the table of seman-
					 tics  and  styles  (toss) element
					 are used to select the	 font  for
					 the block.
       length	  NUMBER      Optional	 By default, the length	of a block
					 is determined	dynamically  as	 a
					 function  of its content and ren-
					 dering	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 for se-
					 lective presentation of a  block.
					 This attribute	defaults to all.
		  help
		  tutorial
		  ref
		  sys
       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  at-
					 tribute 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 re-
					 flect	the meaning  of	the markup
					 in the	original  document  or	it
					 may
					  reflect the actual generic iden-
					 tifier	in the original	 document.
					 The  source  semantic	identifier
					 may be	used to	 assist	in  seman-
					 tic  searches of the SDL-conform-
					 ing 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 origi-
					 nal  generic identifiers.

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

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

       <!ATTLIST form	   id	      ID		   #IMPLIED
			   level      NUMBER		   #IMPLIED
			   version    CDATA		   #IMPLIED
			   class      (table	   |
				      cell	   |
				      list	   |
				      item	   |
				      text	   |
				      udeffrmt	   )	   #IMPLIED
			   language   CDATA		   #IMPLIED
			   charset    CDATA		   #IMPLIED
			   length     NUMBER		   #IMPLIED
			   app	      (all	   |
				      help	   |
				      tutorial	   |
				      ref	   |
				      sys	   )	   #IMPLIED
			   ssi	      CDATA		   #IMPLIED >

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  fol-
       lowed 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 el-
					 ement.	The level attribute makes
					 explicit information that is im-
					 plicit	in typical  SGML-conform-
					 ing  documents.  An SDL-conform-
					 ing document may  be  considered
					 to have  been flattened with im-
					 plicit	form nesting  information
					 stored	in the level attribute.
       version	  CDATA	     Optional	 The  version of this element. By
					 default, the version of the form
					 is  the  same	as the version of
					 the   document	 (sdldoc)  unless
					 that  version has been	 overrid-
					 den by	a  version  attribute  in
					 the virtual  page (virpage) con-
					 taining the form.
       class	  table	     Optional	 The class of  a  form	describes
					 the general
		  cell			 purpose  the  form  is	 filling.
					 The class attribute is	 used  in
					 conjunction with the level and
		  list			 ssi   attributes  to  perform	a
					 lookup	in
		  item			 the  table  of	  semantics   and
					 styles	( toss)
		  text			 element.   The	 result	 of  that
					 lookup	is formatting
		  udeffrmt		 and  semantic	information  per-
					 taining 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  at-
					 tributes  plus	 information  re-
					 trieved  from	 the table of se-
					 mantics and styles  (toss)  ele-
					 ment	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 ren-
					 dering	 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.
		  ref
		  sys

       ssi	  CDATA	     Optional	 A  source  semantic  identifier.
					 This  identifier  is	chosen by
					 the author of a higher	level DTD
					 to   SDL  translator. It may ei-
					 ther reflect the meaning  of the
					 markup	 in the	original document
					 or it may
					  reflect  the	 actual	  generic
					 identifier in the original  doc-
					 ument.

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	 rela-
       tionship	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  in-
       formation regarding the presentational style of the form. Cell-specific
       style and style attributes beyond those provided	in the reference  vec-
       tors 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	 di-
					   vided  evenly  among	the columns.
					   Unless  overridden  by  a  column
					   justification  (colj)  specifica-
					   tion	 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.

       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 head row.
		no
       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 de-
       termined	 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	excep-
       tions 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	physi-
       cally 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 element.

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

DESCRIPTION
       The  form data element (	fdata) is a container for information that be-
       longs 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.

SYNOPSIS
       <!ELEMENT p     - - (head*, (key	| sphrase | rev	 |  if	|
		       spc  | snref | anchor |	link | #PCDATA)+)
		       >
       -----------------------------------------------------------

       <!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 in-
       herit 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  se-
       mantics and styles ( toss) element (covered later in this document).

       Paragraphs  may contain text, references	and key	phrases.  The key ele-
       ment (discussed later in	this document) may modify the style of a  por-
       tion  of	 a  paragraph but the modification is always restricted	to the
       current paragraph.

       The attributes of p 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  overrid-
					den 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  re-
					placed with a single space. The
					type attribute is used when the
					author	needs  to represent in-
					formation that is at least par-
					tially	layout-sensitive.  New-
					line characters	are significant
					in  lined  paragraphs  and  all
					whitespace  is	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 doc-
					ument or it may
					 reflect   the	actual	generic
					identifier  in	 the   original
					document.  The	source semantic
					identifier may be used to   as-
					sist  in  semantic  searches of
					the SDL-conforming document  by
					preserving  the	original intent
					of  the	markup.	When the origi-
					nal  markup was	conforming to a
					domain specific	 DTD,  the  ssi
					may  be	  used to enable struc-
					tured searches of the SDL  con-
					forming	 document by preserving
					the original   generic	identi-
					fiers.

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	overrid-
					 den  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 (unfor-
					 matted) and all white space

		 dynamic		 (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-sen-
					 sitive. Newline characters  are
					 significant in	lined paragraphs
					 and all whitespace is	signifi-
					 cant 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 doc-
					 ument or it may
					  reflect   the	 actual	 generic
					 identifier  in	  the	original
					 document.  The	 source	semantic
					 identifier may	be used	to   as-
					 sist  in  semantic  searches of
					 the SDL-conforming document  by
					 preserving  the original intent
					 of  the markup. When the origi-
					 nal  markup was conforming to a
					 domain-specific  DTD,	the  ssi
					 may  be   used	to enable struc-
					 tured searches	of the	SDL-con-
					 forming  document by preserving
					 the original	generic	 identi-
					 fiers.

HEAD
   Purpose
       Heading,	label or caption.

SYNOPSIS
       <!ELEMENT head	  -  - ((key | sphrase | rev | if | spc	|
			  snref	|  anchor  |  link  |  #PCDATA)*,
			  subhead*) >
       -----------------------------------------------------------

       <!ATTLIST head	    id	       ID		   #IMPLIED
			    version    CDATA		   #IMPLIED
			    class      (label	    |
				       head	    |
				       caption	    |
				       annotation   |
				       phead	    |
				       udefhead	    )	   #IMPLIED
			    language   CDATA		   #IMPLIED
			    charset    CDATA		   #IMPLIED
			    type       (literal	    |
				       lined	    |
				       dynamic	    )	   #IMPLIED
			    abbrev     CDATA		   #IMPLIED
			    ssi	       CDATA		   #IMPLIED >

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

       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  overrid-
					  den 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 the head	is
					  filling.
		  head			  The class attribute is used
		  caption		  in conjunction with the level	of
					  the object
		  annotation		  containing the head and ssi  at-
					  tributes
		  phead			  to  perform a	 lookup	in the ta-
					  ble of semantics
		  udefhead		  and styles (toss)  element.  The
					  result of that lookup	is format-
					  ting	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  at-
					  tributes  plus  information  re-
					  trieved  from	  the table of se-
					  mantics and styles  (toss)  ele-
					  ment	 are  used  to	select the
					  font for the head.
       type	  literal      Optional	  Head text may	be  either  unfor-
					  matted or preformatted.
		  lined			  By  default,	paragraph  text	is
					  assumed  to be  dynamic  (unfor-
					  matted)
		  dynamic		  and all white	space (space, tab,
					  newline, etc.) may  be  replaced
					  with	a  single  space. The type
					  attribute is used when  the  au-
					  thor needs to	represent informa-
					  tion that is at least	 partially
					  layout-sensitive.  Newline char-
					  acters are significant in  lined
					  heads	and all	whitespace is sig-
					  nificant in literal heads.
       abbrev	  CDATA	       Optional	  An  abbreviation  allows  simple
					  and/or short text  to	be associ-
					  ated 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 ei-
					  ther reflect the meaning  of the
					  markup  in the original document
					  or it	may
					   reflect  the	  actual   generic
					  identifier in	the original  doc-
					  ument. The source semantic iden-
					  tifier may be	used to	 assist	in
					  semantic searches  of	 the  SDL-
					  conforming  document by preserv-
					  ing the original intent of   the
					  markup. When the original markup
					  conforms to  a  domain  specific
					  DTD, the ssi may be  used to en-
					  able structured searches of  the
					  SDL-conforming  document by pre-
					  serving  the	original   generic
					  identifiers.

SUBHEAD
   Purpose
       Alternate or additional headings, labels	or captions.

SYNOPSIS
       <!ELEMENT subhead    - -	((key |	sphrase	| rev |	 if | spc
			    | snref | anchor | link |  #PCDATA)*)
			    >
       -----------------------------------------------------------

       <!ATTLIST subhead      id	 ID		      #IMPLIED
			      version	 CDATA		      #IMPLIED
			      class	 (label	      |
					 head	      |
					 caption      |
					 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 re-
       fine 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 sub-
					  head	is the same as the version
					  of  the document (sdldoc) unless
					  that	version	has  been overrid-
					  den 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	is used	in
					  conjunction with
		  caption		  the level of the object contain-
					  ing the head to
		  annotation		  which	the subhead belongs
       and ssi
		  phead			  attributes  to  perform a lookup
					  in the table	of  semantics  and
					  styles (toss)	element.
		  udefhead		  The  result  of  that	 lookup	is
					  formatting and
					   semantic information	pertaining
					  to the subhead.
       language	  CDATA	       Optional	  The  language	in which this sub-
					  head was written.
       charset	  CDATA	       Optional	  The character	set of	this  sub-
					  head.	 The language  and charset
					  attributes plus information  re-
					  trieved   from  the table of se-
					  mantics and styles  (toss)  ele-
					  ment are used	to select the sub-
					  head font.
       type	  literal      Optional	  Subhead text may be  either  un-
					  formatted or preformatted.
		  lined			  By  default, subhead text is as-
					  sumed	 to be dynamic	(unformat-
					  ted)
		  dynamic		  and all white	space (space, tab,
					  newline, etc.) may  be  replaced
					  with	a  single  space. The type
					  attribute is used when  the  au-
					  thor needs to	represent informa-
					  tion that is at least	 partially
					  layout-sensitive.  Newline char-
					  acters 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 associ-
					  ated	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 ei-
					  ther reflect the meaning  of the
					  markup  in the original document
					  or it	may
					   reflect  the	  actual   generic
					  identifier in	the original  doc-
					  ument. The source semantic iden-
					  tifier may be	used to	 assist	in
					  semantic searches  of	 the  SDL-
					  conforming  document by preserv-
					  ing the original intent of   the
					  markup. When the original markup
					  conforms to  a  domain  specific
					  DTD, the ssi may be  used to en-
					  able structured searches of  the
					  SDL-conforming  document by pre-
					  serving  the	original   generic
					  identifiers.

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

SYNOPSIS
       <!ELEMENT anchor	      -	O EMPTY	>
       -----------------------------------------------------------

       <!ATTLIST anchor	      id      ID      #REQUIRED	>
       -----------------------------------------------------------------

DESCRIPTION
       The anchor element provides a mechanism for assigning an	ID to an arbi-
       trary 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.

SYNOPSIS
       <!ELEMENT link	  - - ((key | sphrase |	rev |  if | spc	|
			  snref	| anchor | link	| #PCDATA)+) >
       -----------------------------------------------------------

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

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  applica-
       tion 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:

       rid	   IDREF      Required	 The  ID of the	target of the hy-
					 perlink. 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  (vir-
					 page)	to allow reference to ex-
					 ternal	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 (vir-
					 page).	 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 travers-
					 ing the link if  such	traversal
					 is  in	 some  way  expensive  in
					 time.
       descript	   CDATA      Optional	 A general description of the ac-
					 tion  that  takes place when the
					 hyperlink is activated.
       window	   current    Optional	 By default, hyperlinking to  an-
					 other location	in
		   new			 this  document	 or (via indirec-
					 tion) 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. Of-
					 ten, popup windows are	modal and
					 temporary.
       traversal   return     Optional	 By default, the current document
					 and location

		   noreturn		 in the	document are stored on	a
					 push  down stack to  allow back-
					 tracking of hyperlinks. If  this
					 attribute  is specified as nore-
					 turn, 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 ob-
       ject. The result	of resolving that object is that  it  is  interpolated
       into  the document at the point of the snref.  The snref	element	refer-
       ences 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  dis-
       played,	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 iden-
				  tifier and must be unique  within the
				  document.
       -----------------------------------------------------------------

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

SYNOPSIS
       <!ELEMENT refitem      -	- (head*) >
       -----------------------------------------------------------

       <!ATTLIST refitem     rid      IDREF		   #REQUIRED
			     class    (figure	  |
				      in-line	  |
				      button	  |
				      icon	  |
				      udefgraph	  |
				      table	  |
				      cell	  |
				      list	  |
				      item	  |
				      text	  |
				      udeffrmt	  )	   #REQUIRED
			     button   IDREF		   #IMPLIED
			     ssi      CDATA		   #IMPLIED >

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 at-
				       tributes	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.
		item
		text
		udeffrmt
       button	IDREF	    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
				       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 acti-
				       vated.
       ssi	CDATA	    Optional   A source	semantic identifier. This
				       identifier is  chosen by	 the  au-
				       thor 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  iden-
				       tifier  in  the original	document.
				       The source semantic identifier may
				       be  used	 to   assist  in semantic
				       searches	 of  the   SDL-conforming
				       document	 by preserving the origi-
				       nal 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 origi-
				       nal  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	alter-
       natives,	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.

SYNOPSIS
       <!ELEMENT rev	- - ((key | sphrase | if |  spc	| snref	|
			anchor | link |	#PCDATA)*) >
       -----------------------------------------------------------

DESCRIPTION
       Surrounding  data  with a rev element signals to	the formatter that the
       surrounded data should be marked	somehow	as  having  undergone  change.
       Typically,  this	 mark is change	bars on	the side of the	data. An empty
       rev element implies some	text has been deleted.

       The rev element has no attributes.

KEY
   Purpose
       Effect a	change in font.

SYNOPSIS
       <!ELEMENT key  -	- ((key	| sphrase | rev	| if | spc | anchor | snref | #PCDATA)+) >

       <!ATTLIST key	 charset   CDATA		  #IMPLIED
			 class	   (acro	|
				   book		|
				   emph		|
				   jargon	|
				   l10n		|
				   name		|
				   quote	|
				   product	|
				   termdef	|
				   term		|
				   mach-in	|
				   mach-out	|
				   mach-cont	|
				   pub-lit	|
				   udefkey	)	  #REQUIRED
			 ssi	   CDATA		  #IMPLIED >

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 navi-
       gation.	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	 docu-
       ments.	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 op-
       tional source semantic identifier ( ssi).

       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  at-
					tributes
					 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
		 emph
		 jargon
		 l10n
		 name
		 quote
		 product
		 pub-lit
		 termdef
		 term
		 mach-in
		 mach-out
		 mach-cont
		 udefkey

       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 doc-
					ument or it may
					 reflect   the	actual	generic
					identifier in the original doc-
					ument.	 The   source  semantic
					identifier may be used to   as-
					sist  in  semantic  searches of
					the SDL-conforming document  by
					preserving  the	original intent
					of  the	markup.	When the origi-
					nal  markup  conforms  to a do-
					main-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 su-
       per.

       The attributes of sphrase are:

       style	super	   Required    Indicates  whether  the	sphrase
				       should be set
		sub		       in 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  ei-
				       ther reflect the	meaning	 of the
				       markup in the original  document
				       or it may
					reflect	  the	actual	generic
				       identifier in the original  doc-
				       ument. The source semantic iden-
				       tifier	assists	  in   semantic
				       searches	 of  the SDL-conforming
				       document	by preserving the orig-
				       inal intent of  the markup. When
				       the original markup conforms  to
				       a  domain-specific  DTD,	the ssi
				       may be  used  to	 enable	 struc-
				       tured  searches	of the SDL-con-
				       forming document	 by  preserving
				       the  original   generic	identi-
				       fiers.

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	 enti-
       ties  because  entities	are  global to a document and, for performance
       reasons,	SDL applications often do not wish to process all  global  in-
       formation 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     Publish-
				       ing//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 ele-
       ments.

       The  if	element	 consists  of  a  condition ( cond) followed by	a then
       clause and an optional else clause. Based on the	result of  the	condi-
       tion, either the	then clause or the else	clause is included in the doc-
       ument. If the condition is false	and no else clause exists, the if ele-
       ment 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	speci-
       fied 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	 embed-
					  ded  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.

SYNOPSIS
       <!ELEMENT then	    - -	(key | sphrase | rev | if |
			     spc | snref | anchor | link | #PCDATA)*) >
       -------------------------------------------------------------------

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.

SYNOPSIS
       <!ELEMENT else -	- (key | sphrase | rev | if | spc | snref | anchor | link | #PCDATA)*) >

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  but-
       ton. 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:

       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 sys-
					tem notation block of the  cur-
					rent virtual
					 page. The script in the script
					element	provides  a   mechanism
					for performing any setup neces-
					sary 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  charac-
       ter 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  docu-
					 ment.
       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 infor-
					 mation	retrieved from	the ta-
					 ble of	 semantics  and	 styles
					 (toss)	 element   are	used to
					 select	the text font.

AUDIO
   Purpose
       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  at-
       tribute	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 docu-
					ment)  in the  system  notation
					block  of  the	current	virtual
					page. The script in the	 script
					element	 provides  a  mechanism
					for performing any setup neces-
					sary   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 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  docu-
					 ment.
       format	  CDATA	     Required	 The  format in	which the video
					 clip is stored.

       method	  IDREF	     Optional	 A reference to	a  script  ele-
					 ment  (covered	 later	in this
					 document)  in the system nota-
					 tion block of the current vir-
					 tual  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  de-
       scribing	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	 anima-
				       tion sequence 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  per-
				       forming	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	desig-
       nated 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 ele-
					  ment.	One of the
		sh			  listed interpreters is  often
					  embedded in the
		ksh			  application  and does	not re-
					  quire	another
		csh			  process to  execute.	If  the
					  specified   interpreter  does
					  not exist, the default return
					  value	is NULL.

CROSSDOC
   Purpose
       Indirect	 element  for  following a hyperlink outside the current docu-
       ment.

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	hyper-
       link to an external document. To	create an external, cross-document hy-
       perlink,	a link to the crossdoc is placed in the	text. The crossdoc el-
       ement  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 ex-
				     ternal 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	hyper-
       link  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:

       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	hyper-
       link  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  con-
       tains 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	hyper-
       link to (execution of) a	system command.	To create a system command hy-
       perlink,	 a link	to the sys-cmd is placed in the	text. The sys-cmd ele-
       ment contains the necessary information to find and execute the	system
       command.

       The attributes of sys-cmd are:

       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 sys-
				    tem	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	hyper-
       link 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 call-
				      back.

SWITCH
   Purpose
       Conditional hyperlink.

SYNOPSIS
       <!ELEMENT switch	      -	- CDATA	>
       -----------------------------------------------------------

       <!ATTLIST switch	   id	       ID		   #REQUIRED
			   interp      NOTATION
				       (tcl	    |
				       sh	    |
				       ksh	    |
				       csh	    )	   #IMPLIED
			   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 ( 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	hyper-
       link 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  iden-
					    tifier  and	 must  be unique
					    within the document.
       interp	  NOTATION -	Optional    The	interpreter to which  to
					    pass the
		  tcl			    CDATA  content of the switch
					    element. It	is expected that
					    the
		  sh			    interpreter	 returns  a  nu-
					    meric string value
		  ksh			    equal  to  or  greater  than
					    zero. One of the

		  csh			    listed interpreters	is often
					    embedded in	the  application
					    and	does not require another
					    process to execute.	 If  the
					    specified  interpreter  does
					    not	exist, or   returns  ei-
					    ther  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 hyper-
					    link 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.

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

       <!ELEMENT id	 - O EMPTY >
       -----------------------------------------------------------

       <!ATTLIST id	  type	    (virpage	  |
				    block	  |
				    form	  |
				    p		  |
				    cp		  |
				    head	  |
				    subhead	  |
				    anchor	  |

				    switch	  |
				    snref	  |
				    graphic	  |
				    text	  |
				    audio	  |
				    video	  |
				    animate	  |
				    crossdoc	  |
				    man-page	  |
				    textfile	  |
				    sys-cmd	  |
				    script	  |
				    callback	  )	   #REQUIRED
			  rid	    IDREF		   #REQUIRED
			  rssi	    CDATA		   #IMPLIED
			  rlevel    NUMBER		   #IMPLIED
			  offset    NUMBER		   #REQUIRED >

DESCRIPTION
       The loids element is a container	for a list of identifiers in the docu-
       ment. 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  cur-
       rently being displayed.

       The attribute of	loids is:

       count	NUMBER	     Optional	The  number of id elements con-
					tained in the loids.  This  at-
					tribute,  if  present,	can  be
					used by	the processor  to  pre-
					allocate  space	for the	id ele-
					ments.
       -----------------------------------------------------------------

       The attributes of id are:

       type	virpage	    Required	 The  name  of	the  element  to
					 which this id
		block			 belongs.
		form
		p
		cp
		head
		subhead
		anchor
		switch
		snref
		graphic
		text
		audio
		video
		animate
		crossdoc
		man-page
		textfile
		sys-cmd
		script
		callback
       rid	IDREF	    Required	 The referenced	identifier.
       rssi	CDATA	    Optional	 The  source semantic identifier
					 ( ssi)	of the	element	  refer-
					 enced by the rid attribute.
       rlevel	NUMBER	    Optional	 The level of the element refer-
					 enced	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  attri-
					 bute.

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*) >
       -----------------------------------------------------------

       <!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 dis-
       play  an	 index for the document. It is created during translation of a
       higher level DTD-conforming document to conform to SDL; that is,	an in-
       dex 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 head-
					 ing of	the index.
       count	 NUMBER	     Optional	 The number of entry  elements
					 contained  in the  index. The
					 processor cn use this	attri-
					 bute  (if  this  attribute is
					 present)   to	  pre-allocate
					 space	for  the  entry	  ele-
					 ments.

       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
       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  con-
       structs	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	trans-
       lation and the lophrases	element	contains only those used in the	trans-
       lation 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*)>
       -----------------------------------------------------------

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 identi-
       fier) attributes	to allow general and specific semantic	or  structured
       searches.  A phrase attribute of	many of	the toss sub-elements also as-
       sists 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 doc-
       ument  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  at-
				       tribute is present) to pre-allo-
				       cate space for the styles.
       -----------------------------------------------------------------

KEYSTYLE
   Purpose
       Provides	font and semantic information for key phrases.

SYNOPSIS
       <!ELEMENT keystyle	- O EMPTY >
       -----------------------------------------------------------

       <!ATTLIST keystyle     class	  (acro	       |
					  book	       |
					  emph	       |
					  jargon       |
					  l10n	       |
					  name	       |
					  quote	       |
					  product      |
					  termdef      |
					  term	       |
					  mach-in      |
					  mach-out     |
					  mach-cont    |
					  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:

       class	   acro		Required    The	general	type of	the key	element
					    in
		   book			    the	document.
		   emph
		   jargon
		   l10n
		   name
		   quote
		   product
		   pub-lit
		   termdef
		   term
		   mach-in
		   mach-out
		   mach-cont
		   udefkey
       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	identi-
					    fier in the	original  document. The
					    source  semantic  identifier may be
					    used   to	 assist	  in   semantic
					    searches of	the SDL-conforming doc-
					    ument by  preserving  the  original
					    intent  of	 the  markup.  When the
					    original markup conforms to	 a  do-
					    main-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  describ-
					    ing	 the semantics (meaning) of the
					    element in the original  SGML docu-
					    ment  that was translated into this
					    key. This phrase  can  be  used  to
					    present an interface to  the reader
					    for	searching or otherwise	examin-
					    ing	 the document.
       srch-wt	   NUMBER	Optional    A  number indicating the likelihood
					    that this element contains	an  ac-
					    tual  hit  when  doing  a full-text
					    search. It may be used as  a  rele-
					    vance 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;
					    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 envi-
					    ronment
					     (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  descrip-
					    tions
       xlfdb				    (XLFD)  typeface  names  for use on
					    the	X
       xlfdib				    Window System. Specified, for exam-
					    ple,  as ``-adobe-helvetica-bold-i-
					    narrow-*-''.  The  four  specifica-
					    tions  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  specifica-
					    tions.
       style	   serif	Optional    The	font style.
		   sans-serif
		   symbol
       spacing	   monospace	Optional    Specifies fixed versus proportional
		   propspace		    spacing.
       weight	   medium	Optional    Specifies normal versus bold font.
		   bold
       slant	   roman	Optional    Specifies  Roman, italic or	reverse
					    italic
		   italic		    font.
		   rev-italic
       special	   underline	Optional    Special attribute of the font.  The
					    underline value is
		   strikeout		    interpreted	 as appropriate	for the
					    font.
		   none			    Some non-European fonts  use  over-
					    lining 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	)     #IMPLIED
			      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
			      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
			      f-margin	  CDATA			      #IMPLIED
			      l-margin	  CDATA			      #IMPLIED
			      r-margin	  CDATA			      #IMPLIED
			      t-margin	  CDATA			      #IMPLIED
			      b-margin	  CDATA			      #IMPLIED
			      border	  (no-border		|
					  full-border		|
					  horizontal-border	|
					  vertical-border	|
					  top-border		|
					  bottom-border		|
					  left-border		|
					  right-border		)     #IMPLIED
			      justify	  (left-justify		|
					  right-justify		|
					  center-justify	|
					  numeric-justify	)     #IMPLIED
			      vjust	  (top-vjust		|
					  bottom-vjust		|
					  center-vjust		)     #IMPLIED >

DESCRIPTION
       The  headstyle  element provides	semantic, font and formatting informa-
       tion 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	speci-
       fies an rlevel attribute, the search is further refined by matching the
       level  of the element containing	the heading to the rlevel of the head-
       style. If the element containing	the heading does not have a level  at-
       tribute,	 the  level  of	 its containing	element	is used, and so	on.  A
       headstyle element with no ssi specified matches any ssi in a head  ele-
       ment although an	explicit class/ssi pair	is chosen in preference.

       When  a match is	found, the font	and style information 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
		   head				    document.
		   annotation
		   phead
		   udefhead
       ssi	   CDATA		 Optional   A source semantic identifier. This
						    identifier is  chosen by  the  au-
						    thor 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	 iden-
						    tifier  in the original  document.
						    The	source semantic	identifier may
						    be	used  to   assist  in semantic
						    searches  of  the	SDL-conforming
						    document  by preserving the	origi-
						    nal	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	origi-
						    nal	 generic identifiers.
       rlevel	   NUMBER		 Optional   Used to further refine matches  of
						    the	 class and ssi	attributes. If
						    present, the rlevel	of  the	 head-
						    style 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 describ-
						    ing	the semantics (meaning)	of the
						    element in the original  SGML doc-
						    ument  that	 was  translated  into
						    this   heading. This phrase	can be
						    used to present  an	 interface  to
						    the	reader for searching or	other-
						    wise examining  the	document.
       srch-wt	   NUMBER		 Optional   A number indicating	the likelihood
						    that  this element contains	an ac-
						    tual hit when  doing  a  full-text
						    search.
       srch-wt	   NUMBER		 Optional   A number indicating	the likelihood
						    that this element contains an  ac-
						    tual  hit  when  doing a full-text
						    search.
       orient	   left-orient		 Optional   The	horizontal orientation of  the
						    head with
		   center-orient		    respect  to	its associated element
						    or of
		   right-orient			    the	subhead	with  respect  to  its
						    head. The
		   left-margin-orient		    default   is  center-orient.  This
						    value is used in
		   right-margin-orient		    conjunction	 with  the  vorientat-
						    tribute to orient the heading. The
						    corner orientations

		   left-corner-orient		    are	to place the heading in	one of
						    the	four
		   right-corner-orient		    corners   above   or  below	 (top-
						    vorient or bottom-vorient) and  to
						    the	 right	or left	(right-corner-
						    orient or  left-corner-orient)  of
						    the	associated element. The	margin
						    orientations left or right	justi-
						    fied  this heading with respect to
						    the	text of	 the  heading  parent.
						    For	example, a headstyle with ori-
						    ent=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
		   bottom-vorient		    with respect to its	associated el-
						    ement or of	the subhead  with  re-
						    spect to its head.
		   center-vorient		    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 at-
						    tribute 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
						    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
		   vert				    collides with one already  placed.
						    Horizontal
						     stacking  means place this	one to
						    the	right of the  other.  Vertical
						    stacking
						     means  place  this	 one under the
						    other. This	attribute  should  de-
						    fault to vert.
       flow	   wrap			 Optional   Specifies  whether the text	of the
						    containing
		   nowrap			    element  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
		   xlfdi			    group. They	are X logical font de-
						    scription
		   xlfdb			    (XLFD)  typeface  names for	use on
						    the	X  Window  System.  Specified,
						    for	example, as
		   xlfdib			    ``-adobe-helvetica-bold-i-nar-
						    row-*-''. The four	specifications
						    are	 for  normal, italic, bold and
						    bold-italic. This attribute	should
						    only  be  specified	if the	author
						    is sure of the  desired  font.  In
						    the	 usual	case, only the logical
						    typeface specifications  (	style,
						    spacing, weight, slant) is given.
       typenam	   CDATA		 Optional   These  attributes should always be
						    specified as a
		   typenami			    group.  They  are  the  MS-Windows
						    typeface
		   typenamb			    name  with a maximum of 32 charac-
						    ters. There	is
		   typenamib			    one	specification each for normal,
						    italic,   bold   and  bold-italic.
						    These attributes  should  only  be
						    specified if the author is sure of
						    the	desired	font and, in the usual
						    case,  only	 provide the following
						    logical type specifications.
       style	   serif		 Optional   The	font style.
		   sans-serif
		   symbol
       spacing	   monospace		 Optional   Specifies  fixed  versus   propor-
						    tional spacing.
		   propspace
       weight	   medium		 Optional   Specifies normal versus bold font.
		   bold
       slant	   roman		 Optional   Specifies Roman, italic or reverse
						    italic font.
		   italic
		   rev-italic
       special	   underline		 Optional   Special attribute of the font. The
						    underline value is
		   strikeout			    interpreted	as appropriate for the
						    font.
		   none				    Some non-European fonts use	 over-
						    lining 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 indi-
						    cate 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 ad-
						    ditive,  that  is,	if  an element
						    has	a left margin  and  is	(logi-
						    cally)   contained in another ele-
						    ment 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	(logi-
						    cally)  contained in another  ele-
						    ment  having  a  right margin, the
						    contained  element	will  have   a
						    right  margin  equal to the	sum of
						    the	two values. This value is mea-
						    sured    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)  con-
						    tained in another element having a
						    top	 margin, the two elements  to-
						    gether 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 an-
						    other  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.
		   full-border
		   horizontal-border
		   vertical-border
		   top-border
		   bottom-border
		   left-border
		   right-border
       justify	   left-justify		 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.
		   numeric-justify
       vjust	   top-vjust		 Optional   The	 alignment of the head or sub-
						    head
		   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  subhead,
						    the	bottom,	or the center. In gen-
						    eral, the vjust attribute  may  be
						    seen  as  justifying  text	verti-
						    cally. If a	head or	subhead	is be-
						    ing	 placed	alongside another head
						    or subhead and the	other  one  is
						    longer  than the one being placed,
						    the	one being placed has  an   im-
						    plicit 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		     |
					 italic		     |
					 rev-italic	     )	     #IMPLIED
			     special	 (underline	     |
					 strikeout	     |
					 none		     )	     #IMPLIED
			     f-margin	 CDATA			     #IMPLIED
			     l-margin	 CDATA			     #IMPLIED
			     r-margin	 CDATA			     #IMPLIED
			     t-margin	 CDATA			     #IMPLIED
			     b-margin	 CDATA			     #IMPLIED
			     border	 (no-border	     |
					 full-border	     |
					 horizontal-border   |
					 vertical-border     |
					 top-border	     |
					 bottom-border	     |
					 left-border	     |
					 right-border	     )	     #IMPLIED
			     vjust	 (top-vjust	     |
					 bottom-vjust	     |
					 center-vjust	     )	     #IMPLIED >

DESCRIPTION
       The formstyle element provides semantic,	font and  formatting  informa-
       tion 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	speci-
       fies 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
		   cell				  document.

		   list
		   item
		   text
		   udeffrmt
       ssi	   CDATA	       Optional	  A source semantic identifier.	This
						  identifier  is   chosen by the au-
						  thor 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 iden-
						  tifier in the	original   document.
						  The source semantic identifier may
						  assist in semantic searches of the
						  SDL-conforming  document  by	pre-
						  serving  the	original  intent  of
						  the	markup.	 When  the  original
						  markup conforms to a	domain	spe-
						  cific	DTD, the ssi may be  used to
						  enable structured searches of	 the
						  SDL-conforming  document  by	pre-
						  serving  the	 original    generic
						  identifiers.
       rlevel	   NUMBER	       Optional	  Used	to further refine matches of
						  the class and	ssi  attributes.  If
						  present,  the	 rlevel	of the form-
						  style	is matched against the nest-
						  ing  level  of the form being	for-
						  matted.
       phrase	   CDATA	       Optional	  A natural language phrase describ-
						  ing the semantics (meaning) of the
						  element in the original  SGML	doc-
						  ument	 that  was  translated	into
						  this	form.  This  phrase  can  be
						  used	to  present  an	interface to
						  the reader for searching or other-
						  wise examining the document.
       srch-wt	   NUMBER	       Optional	  A number indicating the likelihood
						  that this element contains an	 ac-
						  tual	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	 to-
						  tal.	Specifications take the	form
						  D[,T[,G]] where ``D''	is the	 de-
						  sired	  (optimal)   column  width,
						  ``T''	is the	amount the column is
						  willing  to  grow  (take) and,  if
						  ``G''	is unspecified,	 willing  to
						  give	(that  is,  plus  or minus).
						  ``G''	is the amount the column  is
						  willing  to  shrink (give). Column
						  specifications are delimited by  a
						  space.   For example,	a specifica-
						  tion 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  unsplit-
						  table	 word	that  pushes it	over
						  the size specified,  a  horizontal
						  scrollbar  is	added and the avail-
						  able space is	 grown until the re-
						  quirement can	be met.	A specifica-
						  tion of:  COLW=``20,5	 80,5''	 im-
						  plies	 two  columns with the first
						  optimally taking 20% and the	sec-
						  ond  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 ad-
						  justed to contain a graphic or un-
						  splittable   word,   a  horizontal
						  scrollbar is	added and the avail-
						  able	space is grown until the re-
						  quirement is met. Finally, a spec-
						  ification    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 specifi-
						  cation   could   take	  the  form:
						  COLW=``20,5 80,0,5''	that  trans-
						  lates	 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 de-
						  sires	80% of the
						   available space, but	 is  willing
						  to take as little as	75%. The to-
						  tals in the above examples usually
						  add  up to 100. This value is	mere
						  convention for
						   ease	of use.	In practice, the sum
						  of desired points  may be any	num-
						  ber.	If  the	 number	 of  columns
						  specified  is	 greater  than	 the
						  ncols	attribute of the  fstyle  of
						  the related  form, the extra spec-
						  ifications  are  ignored.  If	 the
						  number  of  columns  specified  is
						  less than  the   ncols  attribute,
						  the  final specification is repli-
						  cated	 to cover the actual  number
						  of columns.
       colj	   CDATA	       Optional	  The  column  justification  is the
						  default justification	 applied  to
						  each cell in the column. This	 at-
						  tribute is a list of ncols letters
						  chosen  from:	``l,'' ``r,'' ``c,''
						  and ``d.'' These  letters  specify
						  left,	 right,	centered and decimal
						  justification,       respectively.
						  This attribute defaults to ``l.''
       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	common desktop envi-
						  ronment
						   (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-nar-
						  row-*-''. 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
       typenami					  as a group with a maximum of 32
       typenamib				  characters.  There is	one specifi-
						  cation each for   normal,  italic,
						  bold	and  bold-italic.  These at-
						  tributes should only be  specified
						  if  the  author is sure of the de-
						  sired	 font	and,  in  the  usual
						  case,	only provides the  following
						  logical type specifications.
       style	   serif	       Optional	  The font style.
		   sans-serif
		   symbol
       spacing	   monospace	       Optional	  Specifies  fixed  versus   propor-
						  tional spacing.
		   propspace
       weight	   medium	       Optional	  Specifies normal versus bold font.
		   bold
       slant	   roman	       Optional	  Specifies Roman, italic or reverse
						  italic font.
		   italic
		   rev-italic
       special	   underline	       Optional	  Special attribute of the font. The
						  underline
		   italic			  value	 is interpreted	as appropri-
						  ate for the font.
		   rev-italic			  Some non-European fonts use  over-
						  lining for
		   strikeout			  the  purpose filled by underlining
						  in European
		   none				  fonts.

       l-margin	   NUMBER	       Optional	  The left margin. This	value is ad-
						  ditive,  that	 is,  if  an element
						  has a	left margin  and  is  (logi-
						  cally)   contained in	another	ele-
						  ment 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 (logi-
						  cally)  contained in another	ele-
						  ment	having	a  right margin, the
						  contained  element  will  have   a
						  right	 margin	 equal to the sum of
						  the two values. This value is	mea-
						  sured	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)	con-
						  tained in another element having a
						  top  margin, the two elements	will
						  together  have a top	margin equal
						  to the greater of  the  two.	This
						  value	 is measured in	current	line
						  height and  defaults to zero.
       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 an-
						  other	 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.
		   full-border
		   horizontal-border
		   vertical-border
		   top-border
		   bottom-border
		   left-border
		   right-border
       vjust	   top-vjust	       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		     |
					 sans-serif	     |
					 symbol		     )	    #IMPLIED
			     spacing	 (monospace	     |
					 propspace	     )	    #IMPLIED
			     weight	 (medium	     |
					 bold		     )	    #IMPLIED
			     slant	 (roman		     |
					 italic		     |
					 rev-italic	     |	    #IMPLIED
			     special	 (underline	     |
					 strikeout	     |
					 none		     )	    #IMPLIED
			     f-margin	 CDATA			    #IMPLIED
			     l-margin	 CDATA			    #IMPLIED
			     r-margin	 CDATA			    #IMPLIED
			     t-margin	 CDATA			    #IMPLIED
			     b-margin	 CDATA			    #IMPLIED
			     border	 (no-border	     |
					 full-border	     |
					 horizontal-border   |
					 vertical-border     |
					 top-border	     |
					 bottom-border	     |
					 left-border	     |
					 right-border	     )	    #IMPLIED
			     vjust	 (top-vjust	     |
					 bottom-vjust	     |
					 center-vjust	     )	    #IMPLIED
			     justify	 (left-justify	     |
					 right-justify	     |
					 center-justify	     |
					 numeric-justify     )	    #IMPLIED >

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

       When a one of the elements listed in the	FRMSTYLE Synopsis  is  encoun-
       tered  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 at-
       tributes	of the frmtstyle. If the frmtstyle specifies an	rlevel	attri-
       bute,  the  search is further refined by	matching the level of the ele-
       ment containing the element to the rlevel of the	frmtstyle. If the ele-
       ment  does not have a level attribute, the level	of its containing ele-
       ment 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 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.
		   list
		   item
		   text
		   udeffrmt

       ssi	   CDATA	       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  re-
						  flect	the actual generic identifier
						  in   the  original   document.  The
						  source semantic identifier  may  be
						  used	 to    assist	in   semantic
						  searches of the SDL-conforming doc-
						  ument	 by  preserving	 the original
						  intent of   the  markup.  When  the
						  original  markup  conforms to	a do-
						  main-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	frmt-
						  style	is  matched against the	level
						  of the element being	formatted or,
						  if  none,  the  level	 of the	first
						  containing element with a level at-
						  tribute.
       phrase	   CDATA	       Optional	  A  natural language phrase describ-
						  ing the semantics (meaning) of  the
						  element in the original  SGML	docu-
						  ment that was	translated into	 this
						  element. This	phrase can be used to
						  present an interface to  the reader
						  for  searching or otherwise examin-
						  ing  the document.
       srch-wt	   NUMBER	       Optional	  A number indicating the  likelihood
						  that	this  element contains an ac-
						  tual hit  when  doing	 a  full-text
						  search.
       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)
       xlfdb					  typeface names for  use  on  the  X
						  Window  System.  Specified, for ex-
						  ample,
       xlfdib					  as   ``-adobe-helvetica-bold-i-nar-
						  row-*-''.   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
       typenamb					  names	with a maximum of 32  charac-
						  ters.

       typenamib				  There	is one specification each for
						  normal,  italic,  bold  and	bold-
						  italic.   These  attributes  should
						  only be specified if the author  is
						  sure	of  the	 desired font. In the
						  usual	case, only the logical	type-
						  face	specifications	(style,	spac-
						  ing, weight, slant) are  given.
       style	   serif	       Optional	  The font style.
		   sans-serif
		   symbol
       spacing	   monospace	       Optional	  Specifies fixed versus proportional
		   propspace			  spacing.
       weight	   medium	       Optional	  Specifies normal versus bold font.
		   bold
       slant	   roman	       Optional	  Specifies Roman, italic or  reverse
						  italic
		   italic			  font.
		   rev-italic
       special	   underline	       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 pur-
						  pose filled by underlining in	Euro-
						  pean	fonts.
       f-margin	   CDATA	       Optional	  The  first  line  margin (it may be
						  negative).  A	number used to	indi-
						  cate	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 ad-
						  ditive, that is, if  an element has
						  a  left  margin  and is (logically)
						  contained in another element having
						  a  left  margin, the contained ele-
						  ment will have a left	margin	equal
						  to  the sum of the two values. This
						  value	is measured in current	char-
						  acter	 widths. The default value is
						  zero.
       r-margin	   NUMBER	       Optional	  The right margin. This value is ad-
						  ditive, that is, if  an element has
						  a right margin and  is  (logically)
						  contained in another element having
						  a right margin, the contained	 ele-
						  ment will have a right margin	equal
						  to the sum of	the two	values.	 This
						  value	 is measured in	current	char-
						  acter	 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 (logi-
						  cally) contained in another element
						  having a bottom margin, the two el-
						  ements  together have	a bottom mar-
						  gin  equal  to  the  greater of the
						  two. This value is measured in cur-
						  rent line height. The	default	value
						  is zero
       border	   no-border	       Optional	  Specifies the	decoration type.
		   full-border			  The default is no-border.
		   horizontal-border

		   vertical-border
		   top-border
		   bottom-border
		   left-border
		   right-border
       vjust	   top-vjust	       Optional	  Vertical justification of the	 text
						  of
		   bottom-vjust			  this	element.  The default is top-
						  vjust.
		   center-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
		   numeric-justify		  alignment 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 >
       -----------------------------------------------------------

       <!ATTLIST grphstyle   (class	figure		    |
					in-line		    |
					button		    |
					icon		    |
					udefgrph	    )	   #REQUIRED
			     ssi	CDATA			   #IMPLIED
			     rlevel	NUMBER			   #IMPLIED
			     phrase	CDATA			   #IMPLIED
			     l-margin	CDATA			   #IMPLIED
			     r-margin	CDATA			   #IMPLIED
			     t-margin	CDATA			   #IMPLIED
			     b-margin	CDATA			   #IMPLIED
			     border	(no-border	    |
					full-border	    |
					horizontal-border   |
					vertical-border	    |
					top-border	    |
					bottom-border	    |
					left-border	    |
					right-border	    )	   #IMPLIED
			     vjust	(top-vjust	    |
					bottom-vjust	    |
					center-vjust	    )	   #IMPLIED
			     justify	(left-justify	    |
					right-justify	    |
					center-justify	    )	   #IMPLIED >

DESCRIPTION
       The grphstyle element provides semantic,	font and  formatting  informa-
       tion 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 ele-
       ment  with  no ssi specified, matches any ssi in	a refitem element, al-
       though 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.
		  button
		  icon
		  udefgrph
       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 identi-
						 fier in the original  document. The
						 source	semantic identifier  may  be
						 used	to    assist   in   semantic
						 searches of the SDL-conforming	doc-
						 ument	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
						 grphstyle  is	matched	 against the
						 level of the first containing	ele-
						 ment with level attribute.
       phrase	  CDATA		      Optional	 A  natural language phrase describ-
						 ing the semantics (meaning) of	 the
						 element in the	original  SGML docu-
						 ment that was translated into	this
						 element. This phrase can be used to
						 present an interface to  the reader
						 for  searching	or otherwise examin-
						 ing  the document.
       l-margin	  NUMBER	      Optional	 The left margin. This value is	 ad-
						 ditive, that is, if  an element has
						 a left	margin	and  is	 (logically)
						 contained in another element having
						 a left	margin,	the  contained	ele-
						 ment will have	a left margin  equal
						 to the	sum of the two values.	This
						 value	is measured in current char-
						 acter	widths.	The default value is
						 zero.
       r-margin	  NUMBER	      Optional	 The right margin. This	value is ad-
						 ditive, that is, if  an element has
						 a  right  margin and is (logically)
						 contained in another element having
						 a  right margin, the contained	ele-
						 ment will have	a right	margin equal
						 to  the sum of	the two	values.	This
						 value is measured in current  char-
						 acter	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  (logi-
						 cally)	contained in another element
						 having	a bottom margin, the two el-
						 ements	 together have a bottom	mar-
						 gin equal to the   greater  of	 the
						 two. This value is measured in	cur-
						 rent line height. The default value
						 is zero.
       border	  no-border	      Optional	 Specifies the decoration type.
		  full-border			 The default is	no-border.
		  horizontal-border
		  vertical-border
		  top-border
		  bottom-border
		  left-border
		  right-border
       vjust	  top-vjust	      Optional	 Vertical   justification   of	 the
						 graphic.
		  bottom-vjust			 The default is	top-vjust.
		  center-vjust
       justify	  left-justify	      Optional	 Horizontal  justification  of	 the
						 graphic.
		  right-justifyt		 The default is	left-justify.
		  center-justify

SEE ALSO
       DtCreateHelpDialog(3), DtCreateHelpQuickDialog(3).

							       dtsdldtd(other)

NAME | DESCRIPTION | TOP LEVEL ELEMENTS | SDLDOC | SYNOPSIS | DESCRIPTION | VSTRUCT | SYNOPSIS | DESCRIPTION | VIRPAGE | SYNOPSIS | DESCRIPTION | SNB | SYNOPSIS | DESCRIPTION | BLOCK | SYNOPSIS | DESCRIPTION | FORM | SYNOPSIS | DESCRIPTION | FSTYLE | SYNOPSIS | DESCRIPTION | FROWVEC | SYNOPSIS | DESCRIPTION | FDATA | SYNOPSIS | DESCRIPTION | CONTAINER ELEMENTS | P | SYNOPSIS | DESCRIPTION | CP | SYNOPSIS | DESCRIPTION | HEAD | SYNOPSIS | DESCRIPTION | SUBHEAD | SYNOPSIS | DESCRIPTION | ATOMIC LINK ELEMENTS | ANCHOR | SYNOPSIS | DESCRIPTION | LINK | SYNOPSIS | DESCRIPTION | SNREF | SYNOPSIS | DESCRIPTION | REFITEM | SYNOPSIS | DESCRIPTION | ALTTEXT | SYNOPSIS | DESCRIPTION | ATOMIC TEXT ELEMENTS | REV | SYNOPSIS | DESCRIPTION | KEY | SYNOPSIS | DESCRIPTION | SPHRASE | SYNOPSIS | DESCRIPTION | SPC | SYNOPSIS | DESCRIPTION | CONDITIONAL TEXT ELEMENTS | IF | SYNOPSIS | DESCRIPTION | COND | SYNOPSIS | DESCRIPTION | THEN | SYNOPSIS | DESCRIPTION | ELSE | SYNOPSIS | DESCRIPTION | NOTATION ELEMENTS | GRAPHIC | SYNOPSIS | DESCRIPTION | TEXT | SYNOPSIS | DESCRIPTION | AUDIO | SYNOPSIS | DESCRIPTION | VIDEO | SYNOPSIS | DESCRIPTION | ANIMATE | SYNOPSIS | DESCRIPTION | SCRIPT | SYNOPSIS | DESCRIPTION | CROSSDOC | SYNOPSIS | DESCRIPTION | MAN PAGE | SYNOPSIS | DESCRIPTION | TEXTFILE | SYNOPSIS | DESCRIPTION | SYS-CMD | SYNOPSIS | DESCRIPTION | CALLBACK | SYNOPSIS | DESCRIPTION | SWITCH | SYNOPSIS | DESCRIPTION | GENERATED ELEMENTS | REL-DOCS | SYNOPSIS | DESCRIPTION | SYNOPSIS | DESCRIPTION | NOTES | SYNOPSIS | DESCRIPTION | LOIDS AND ID | SYNOPSIS | DESCRIPTION | INDEX AND ENTRY | SYNOPSIS | DESCRIPTION | LOPHRASES | SYNOPSIS | DESCRIPTION | PHRASE | SYNOPSIS | DESCRIPTION | TOSS | SYNOPSIS | DESCRIPTION | KEYSTYLE | SYNOPSIS | DESCRIPTION | HEADSTYLE | SYNOPSIS | DESCRIPTION | FORMSTYLE | SYNOPSIS | DESCRIPTION | FRMTSTYLE | SYNOPSIS | DESCRIPTION | GRPHSTYLE | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dtsdldtd&sektion=4&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help