diff options
author | Marti Bolivar <mbolivar@leaflabs.com> | 2011-04-07 21:57:15 -0400 |
---|---|---|
committer | Marti Bolivar <mbolivar@leaflabs.com> | 2011-04-07 23:16:53 -0400 |
commit | 686f12ad6728fec15129a98f5d1ec182bab4c6b9 (patch) | |
tree | 45166e1e3cb030cd7f04171d1a8106604f73c0ca /notes | |
parent | b04fc94cfc991855544625af7e67ecf07c02f542 (diff) | |
download | librambutan-686f12ad6728fec15129a98f5d1ec182bab4c6b9.tar.gz librambutan-686f12ad6728fec15129a98f5d1ec182bab4c6b9.zip |
Coding standard tweaks.
Diffstat (limited to 'notes')
-rw-r--r-- | notes/coding_standard.txt | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/notes/coding_standard.txt b/notes/coding_standard.txt index f762e98..5b258f7 100644 --- a/notes/coding_standard.txt +++ b/notes/coding_standard.txt @@ -149,11 +149,11 @@ We'll handle this as follows. it's not crucial. Don't feel obliged to put "_t" at the end of the type name; we don't. -- Macros and constants: all caps, separated by underscores. Variables - with the "const" qualifier aren't considered "constants" for the - purposes of this rule; i.e., case them according to the rules for - variables. (We make an exception for PIN_MAP, but that's because - it's the central data structure for all of Wirish). +- Macros and constants: all caps, separated by underscores. C++ + variables with the "const" qualifier generally aren't considered + "constants" for the purposes of this rule; i.e., they are cased + according to the rules for variables. We make an exception for + PIN_MAP, because it's the central Wirish data structure. - foo.h gets #ifdef'ed to _FOO_H_. @@ -216,7 +216,7 @@ Documentation notes also have a habit of turning into user-facing documentation. - For libmaple proper (the pure C library under libmaple/); the - convention is to document any user-facing entity at the point where + convention is to document any user-facing function at the point where it is defined. In particular, this means you should document an externally-linked function defined in a .c file in that .c file, not in the header file where it is declared to the user. |