7.3. Comment-start Commands

These commands are interpreted only if they appear at the very beginning of a comment. Not even a preceding sequence of whitespace is allowed. The @ character must be the first character of the comment.

7.3.1. {@discard ... }

Ignores the comment. Applies only to one, separate comment, even when comments are joined. For example, from the following two comments only the first one is ignored, even if adjoining comments are merged.

{@discard A comment to ignore. } { This one is not ignored. }

7.3.2. {@decl declaration }

The effect of this comment is that anything after it in the comment is treated af if it was outside a comment. It is often useful when a declaration in a descendant class is not overridden, but nonetheless needs a different description than that in the ancestor.