aboutsummaryrefslogtreecommitdiffstats
path: root/notes
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2011-04-07 21:57:15 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2011-04-07 23:16:53 -0400
commit686f12ad6728fec15129a98f5d1ec182bab4c6b9 (patch)
tree45166e1e3cb030cd7f04171d1a8106604f73c0ca /notes
parentb04fc94cfc991855544625af7e67ecf07c02f542 (diff)
downloadlibrambutan-686f12ad6728fec15129a98f5d1ec182bab4c6b9.tar.gz
librambutan-686f12ad6728fec15129a98f5d1ec182bab4c6b9.zip
Coding standard tweaks.
Diffstat (limited to 'notes')
-rw-r--r--notes/coding_standard.txt12
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.