Comments

What Does Comments Mean?

Comments, in Java, explain the actions of a particular piece of code. They are used to provide a summary of the code in plain English to help future developers better understand the code.

Advertisements

Techopedia Explains Comments

There are five types of comments in Java:

Block comments give a file or method overview and also may be used within a method. A block comment method is declared as follows:
/*
*block comment describing the overview of the code.
*/

Single-line comments are short comments that may be written in a single line. If a single-line comment does not fit in the same line, a block comment must be used. The following is an example of a single-line comment:
If (conditional statement) {
/* execution of conditional statement*/

}
/* is the delimiter for a single-line comment.

Trailing comments are very short comments written in the same line of code that is being described. The delimiters are /*…*/.

End of line comments are written at the end of the line, and the delimiter is //.

Documentation comments, written before the declaration, are used to explain Java interfaces, classes, constructors, methods and fields. The delimiters are /**…*/.

Advertisements

Related Terms

Latest DevOps Terms

Related Reading

Margaret Rouse

Margaret Rouse is an award-winning technical writer and teacher known for her ability to explain complex technical subjects to a non-technical, business audience. Over the past twenty years her explanations have appeared on TechTarget websites and she's been cited as an authority in articles by the New York Times, Time Magazine, USA Today, ZDNet, PC Magazine and Discovery Magazine.Margaret's idea of a fun day is helping IT and business professionals learn to speak each other’s highly specialized languages. If you have a suggestion for a new definition or how to improve a technical explanation, please email Margaret or contact her…