summaryrefslogtreecommitdiffstats
path: root/devel
diff options
context:
space:
mode:
authorDavid Bremner <david@tethera.net>2016-02-13 13:11:19 -0400
committerDavid Bremner <david@tethera.net>2016-03-04 20:45:06 -0400
commit9f8b2091c818d3e81e028d3bf060ff2c95134333 (patch)
treeba54f9b369490d047ccf9897fc5b5ab6d66a5854 /devel
parent99a0a90f65f5a98d2562e36b48b3e423233c2eb4 (diff)
STYLE: suggest long names
Hopefully the exceptions are common sense.
Diffstat (limited to 'devel')
-rw-r--r--devel/STYLE4
1 files changed, 4 insertions, 0 deletions
diff --git a/devel/STYLE b/devel/STYLE
index b22d8d35..da653124 100644
--- a/devel/STYLE
+++ b/devel/STYLE
@@ -71,6 +71,10 @@ Naming
* Use lowercase_with_underscores for function, variable, and type
names.
+* Except for variables with extremely small scope, and perhaps loop
+ indices, when naming variables and functions, err on the side of
+ verbosity.
+
* All structs should be typedef'd to a name ending with _t. If the
struct has a tag, it should be the same as the typedef name, minus
the trailing _t.