669 |
@} |
@} |
670 |
@end example |
@end example |
671 |
|
|
672 |
|
@item |
673 |
|
Avoid the use of reserved words for identifiers. This is obvious with those |
674 |
|
such as @code{if} and @code{while} which have always been part of the Java |
675 |
|
programming language, but you should be careful about accidentally using |
676 |
|
words which have been added in later versions. Notable examples are |
677 |
|
@code{assert} (added in 1.4) and @code{enum} (added in 1.5). Jikes will warn |
678 |
|
of the use of the word @code{enum}, but, as it doesn't yet support the 1.5 |
679 |
|
version of the language, it will still allow this usage through. A |
680 |
|
compiler which supports 1.5 (e.g. the Eclipse compiler, ecj) will simply |
681 |
|
fail to compile the offending source code. |
682 |
|
|
683 |
@c fixme Describe Anonymous classes (example). |
@c fixme Describe Anonymous classes (example). |
684 |
@c fixme Descibe Naming conventions when different from GNU Coding Standards. |
@c fixme Descibe Naming conventions when different from GNU Coding Standards. |
685 |
@c fixme Describee API doc javadoc tags used. |
@c fixme Describee API doc javadoc tags used. |