wordasword
wordasword — A word meant specifically as a word and not representing anything else.
Synopsis
- Zero or more of:
- text
replaceable
- Graphic inlines
- Indexing inlines
- Linking inlines
- Ubiquitous inlines
abbrev
acronym
alt
anchor
annotation
biblioref
coref
date
emphasis
(db._emphasis)firstterm
(db._firstterm)footnote
footnoteref
foreignphrase
(db._foreignphrase)glossterm
(db._glossterm)indexterm
(db.indexterm.endofrange)indexterm
(db.indexterm.singular)indexterm
(db.indexterm.startofrange)inlinemediaobject
link
olink
phrase
(db._phrase)quote
(db._quote)remark
subscript
superscript
trademark
wordasword
xref
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
<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>
A Term in Algebra has a very different
meaning than a term
in DocBook.