notes : Documentation notes (annotations).

[next] [prev] [prev-tail] [tail] [up]

#### 5.3.20 notes : Documentation notes (annotations).

The notes tag indicates that a particular documentation topic contains annotations. It consists of one or more note tags, no other tags are allowed They serve as annotations to the documentation, usually for the benefit of the documentation writer.

As such, notes are by default not included in the final documentation, but they can be added to them with the –emit-notes command-line option.

Notes can appear below the module, topic and element tags.

For an explanation of what can appear inside the note tag itself, see note (203).

Example:

<module name="classes">
<descr>
The classes unit contains basic class definitions for the FCL.
</descr>
<notes>
<note>MVC. This unit needs more documenting</note>
<note>FK The new class MyVeryImportantClass needs documenting</note>
<notes>
</module>

See also: note (203), module (199), topic (228) and element (179).

[next] [prev] [prev-tail] [front] [up]