Comupter assignment

Janjo
AB-JAVA-CodeConvention.pdf

Dr. Adriana Badulescu Programming Fundamentals II Course Code Convention

Your code should be well-documented. Every line of

code should be preceded by a comment or a Javadoc

comment explaining exactly what that line of code is

doing.

Every class should have a Javadoc comment with the following format: /**

*

* DESCRIPTION

* USAGE

*

* @author [author name]

* @version [version]

*

*/

Every method, should have a Javadoc comment with the following format: /**

*

* DESCRIPTION

*

* @param [argument name] [argument

description]

* @return [description of return]

*

*/

Every other line of code (declaration, initialization, assignment, function call, etc), should be preceded by a regular comment explaining what that line of code is doing. One of the 2 formats: /*

DESCRIPTION – multiple lines

*/

or

// DESCRIPTION – one line

Class

Javadoc

comment

Method

Javadoc

comment

Line of code

regular

comment