wordasword — A word meant specifically as a word and not representing anything else
wordasword ::=
alt
anchor
annotation
biblioref
indexterm
(db.indexterm.endofrange)indexterm
(db.indexterm.singular)indexterm
(db.indexterm.startofrange)inlinemediaobject
link
olink
phrase
(db._phrase)remark
replaceable
subscript
superscript
xref
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.
These elements contain wordasword
: bridgehead
, citation
, citetitle
, classsynopsisinfo
, emphasis
(db.emphasis), entry
, firstterm
, foreignphrase
, funcsynopsisinfo
, glosssee
, glossseealso
, glossterm
, html:button
, html:label
, html:legend
, link
, literallayout
, member
, olink
, orgdiv
, para
, phrase
(db.phrase), primary
, primaryie
, programlisting
, quote
, refdescriptor
, refentrytitle
, refname
, refpurpose
, screen
, secondary
, secondaryie
, see
, seealso
, seealsoie
, seeie
, seg
, segtitle
, simpara
, subtitle
, synopsis
, td
, term
, termdef
, tertiary
, tertiaryie
, th
, title
, titleabbrev
, tocentry
.
The following elements occur in wordasword: text, alt
, anchor
, annotation
, biblioref
, indexterm
(db.indexterm.endofrange), indexterm
(db.indexterm.singular), indexterm
(db.indexterm.startofrange), inlinemediaobject
, link
, olink
, phrase
(db._phrase), remark
, replaceable
, subscript
, superscript
, xref
.
<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.