CHAPTER 18: Documentation Comments

Previous

Java Language

Index

Next

Documentation Comments

Java programs can include documentation in their source code, in special documentation comments (S3.7). Such comments can appear before each class or interface declaration and before each method, constructor, or field declaration. Hypertext web pages can then be produced automatically from the source code of the program and these documentation comments.

This chapter gives an informal description of documentation comments. A complete formal specification would require a detailed description of those parts of the Hypertext Markup Language (HTML) that can be used within the documentation comments, which is beyond the scope of this specification.