Submissions to the James project must follow the coding conventions
outlined in this document. James developers
are asked to follow coding conventions already present in the code.
(For example, if the existing code has the bracket on
the same line as the if statement, then all subsequent code
should also follow that convention.) Anything not
explicitly mentioned in this document should adhere to the
official
Sun
Java Coding Conventions.
Developers who commit code that does not follow
the coding conventions outlined in this document will be
responsible for fixing their own code.
1. Spaces between parentheses are optional. The preference is to exclude
extra spaces. Both of these conventions are acceptable:
2. Four spaces. NO tabs. Period. The James
mailing list receives cvs commit messages that are almost impossible
to read if tabs are used.
In Emacs-speak, this translates to the following command:
(setq-default tab-width 4 indent-tabs-mode nil)
3. Use Unix linefeeds for all .java source code files. Only platform-specific
files (e.g. .bat files for Windows) should contain non-Unix linefeeds.
4. Javadoc must exist on all methods. Contributing
a missing javadoc for any method, class, variable, etc., will be GREATLY
appreciated as this will help to improve the James project.
5. The Jakarta Apache/James License MUST be placed
at the top of every file.