I have included API documentation in the form of javadoc and doxygen as well, to illustrate how the special forms of comments get translated into web pages. Both were generated from the same source.
For the javadoc, I have used the -private flag so that private fields are shown in the documentation.
Doxygen requires that you edit a configuration file not shown here. Doxygen allows indexing and cross-indexing of the source code. Also of note is that Doxygen can be used for C++ with the same style of comments.