6.28. wordasword

The <wordasword> tag set is used to define a word meant specifically as a word and not representing anything else.

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.

For example:

	
To use <command>grep</command> to search for the word
<wordasword>linux</wordasword>, use the command 
<command>grep linux</command>.

The output:

To use grep to search for the word linux, use the command grep linux.

In the example, the word "linux" is just a word. It is not meant to convey anything about Linux as a subject, or to add relevance or meaning to the content. It can be replaced with any other word without losing any of the context.