Code Conventions for the Java TM Programming Language
813215Nov 16 2010 — edited Dec 14 2010I am starting this thread for those who care about such things as I was unable to find a thread that is specific to this subject.
http://www.oracle.com/technetwork/java/codeconvtoc-136057.html
The code conventions have not been revised since 1999. I can understand why a documented convention should not be open to just any change. But should it not at least be maintained? Among Java code conventions, this one is the chief source.
There are actually some bugs in the document that should be fixed. This is not just a matter of opinion. Just to get the discussion started, let's begin with the documentation comments in the examples (section 11.1). The examples have become garbled. How can it ever be used as examples of the convention if left in this state?