O'Reilly logo

DocBook 5: The Definitive Guide by Richard L. Hamilton, Norman Walsh

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Name

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

Synopsis

wordasword ::= (text | phrase db._phrase | replaceable | Graphic inlines | Indexing inlines | Linking inlines | Ubiquitous inlines)*

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.

See Also

abbrev, acronym, emphasis, foreignphrase, phrase, quote

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example wordasword</title>

<para>A <wordasword>Term</wordasword> in algebra has a very different
meaning than a <tag>term</tag> in DocBook.
</para>

</article>

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required