version 1.1, 2001/06/16 15:59:44
|
version 1.5, 2001/07/03 18:52:36
|
|
|
|
(Preliminary; still need to be modified and voted on). |
| |
Development Conventions | Development Conventions |
======================= | ======================= |
| |
1. Indent by increments of four. |
1. Indent by increments of four (tabsize of 8). |
| |
2. Use "char* x" rather than "char *x". | 2. Use "char* x" rather than "char *x". |
| |
|
|
platform. | platform. |
| |
22. No binaries may be committed to repository. | 22. No binaries may be committed to repository. |
|
|
|
24. Don't separate return type onto its own line: |
|
|
|
Avoid this: |
|
|
|
int |
|
f() |
|
{ |
|
} |
|
|
|
|
|
25. All code must be reachable (built) from master makefile. Otherwise |
|
it will not be reached when doing mass substitutions, testings of |
|
builds, and license changes. |
|
|
|
26. Prepend '_' to private members (including methods). |
|
|
|
27. Use /** */ rather than /// for DOC++. |
|
|
|
29. Always write a regression test for everything. |
|
|
|
30. Always build and run all regression tests before committing. |
|
|
|
31. Be mindful that the tests must run on all supported platforms and |
|
that a commit may break another platform. |
|
|
|
33. Tests must clean up the effect they have on the repository. |
|
|
|
34. Avoid use of condiational compilation for obscuring platrform |
|
differences. Use (or put) routines in appropriate platform files |
|
or in the System*.cpp files in Common. |