3.7

Comments

LEXICAL STRUCTURE

//

text

A

single line comment

: all the text from the ASCII

characters

//

 to the end of the line is ignored (as in

C++).

/**

documentation

 */

A

documentation comment

: the text enclosed by

the ASCII characters

/**

 and

*/

 can be processed

by a separate tool to prepare automatically

generated documentation of the following class,

interface, constructor, or member (method or field)

declaration. See  18 for a full description of how

the supplied

documentation

 is processed.

These comments are formally specified by the following productions:

Comment:

TraditionalComment

EndOfLineComment

DocumentationComment

TraditionalComment

:

/ *

NotStar CommentTail

EndOfLineComment:

/ /

CharactersInLine

opt

LineTerminator

DocumentationComment:

/ * *

CommentTailStar

CommentTail:

*

CommentTailStar

NotStar CommentTail

CommentTailStar:

/

*

CommentTailStar

NotStarNotSlash CommentTail

NotStar:

InputCharacter

 but not

*

LineTerminator

NotStarNotSlash:

InputCharacter

 but not

*

 or

/

LineTerminator

16