===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/codingconventions.html,v
retrieving revision 1.90
@@ -569,6 +569,17 @@
required if the capital letter is within <code>@code</code> or
<code>@samp</code>.)</li>
+ <li>Use <code>@code</code> for an expression in a program, for the name
+ of a variable or function used in a program, or for a keyword in
+ a programming language. However, avoid <code>@code</code> in uses
+ of language keywords as adjectives. For example, appropriate uses
+ of <code>@code</code> are in phrases such as
+ <i>"<code>@code{const}</code>-qualified type"</i>, or
+ <i>"<code>@code{asm}</code> statement"</i>, or
+ <i>"function returns <code>@code{true}</code></i>".
+ Examples where <code>@code</code> should be avoided are phrases such as
+ <i>"const variable"</i>, <i>"volatile access"</i>, or
+ <i>"condition is false."</i></li>
</ul>