Skip to main content
Version: DocBook V4.5

wordasword

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

Synopsis

Mixed Content Model

wordasword ::=
(#PCDATA|acronym|emphasis|trademark|link|olink|ulink|anchor|
remark|subscript|superscript|inlinegraphic|inlinemediaobject|
indexterm|beginpage)*

Attributes

Common attributes

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.

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.