STYLE: suggest long names

Hopefully the exceptions are common sense.

diff --git a/devel/STYLE b/devel/STYLE
index b22d8d353e15c11c0827bf7adf38e8eefe8843ba..da6531248feb7e827c6f5066faaf1049a61a2652 100644 (file)
--- 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.