wordasword

$Revision: 1666 $

$Date: 2002-06-12 07:19:37 -0400 (Wed, 12 Jun 2002) $

wordasword — A word meant specifically as a word and not representing anything else

Synopsis

Mixed Content Model

wordasword ::=
(%word.char.mix;)*

Attributes

Common attributes

Parameter Entities

The following parameter entities contain wordasword:

Parameter Entities
`%gen.char.class;`	`%ndxterm.char.mix;`	`%para.char.mix;`
`%refinline.char.mix;`	`%tbl.entry.mdl;`	`%title.char.mix;`

Description

A lot of technical documentation contains words that have overloaded meanings. Sometimes it is useful to be able to use a word without invoking its technical meaning. The WordAsWord element identifies a word or phrase that might otherwise be interpreted in some specific way, and asserts that it should be interpreted simply as a word.

It is unlikely that the presentation of this element will be able to help readers understand the variation in meaning; good writing will have to achieve that goal. The real value of WordAsWord lies in the fact that full-text searching and indexing tools can use it to avoid false-positives.

Processing expectations

Formatted inline.

Parents

These elements contain wordasword: application, attribution, bibliomisc, bridgehead, citation, citetitle, emphasis, entry, firstterm, foreignphrase, glosssee, glossseealso, glossterm, lineannotation, link, literallayout, lotentry, member, msgaud, olink, para, phrase, primary, primaryie, productname, programlisting, quote, refentrytitle, refpurpose, remark, screen, screeninfo, secondary, secondaryie, see, seealso, seealsoie, seeie, seg, segtitle, simpara, subtitle, synopsis, td, term, termdef, tertiary, tertiaryie, th, title, titleabbrev, tocback, tocentry, tocfront, ulink.

Children

The following elements occur in wordasword: acronym, anchor, beginpage, emphasis, indexterm, inlinegraphic, inlinemediaobject, link, olink, remark, subscript, superscript, trademark, ulink.

Examples

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<para>
A <wordasword>Term</wordasword> in Algebra has a very different meaning
than a <sgmltag>Term</sgmltag> in DocBook.
</para>

A Term in Algebra has a very different meaning than a Term in DocBook.


warning		xref