Chapter 15. Annotations

 

I don't like spinach, and I'm glad I don't, because if I liked it I'd eat it, and I just hate it.

 
 --Clarence Darrow

The source code for our programs is usually accompanied by copious amounts of informal documentation that typically is contained within comments in the source code file. For example, many organizations have a standard preamble that they place at the top of class source files that contains things like copyright information, the programmers name, the date the class was created, the date the class was last modified, the current revision number, and so forth. Other comments may reflect intended usage of a class or a method, or usage limitations, such as documenting that the instances of a class are not thread-safe ...

Get THE Java™ Programming Language, Fourth Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.