Javadoc
In C++ specifications are put in .h files and implementations
in .cpp files. In Java, only interfaces are put in separate
files.
Appropriate documentation is added to the implementation,
and then we run javadoc program to automatically generate a
set of HTML files as documentation for the code.
Javadoc comments start are delimited by /** and */. Other
useful comments are prefaced by @param, @author,
@return, @throws.