From: David Bremner <david@tethera.net>
Date: Sat, 13 Feb 2016 17:11:19 +0000 (-0400)
Subject: STYLE: suggest long names
X-Git-Tag: 0.22_rc0~49
X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=commitdiff_plain;h=9f8b2091c818d3e81e028d3bf060ff2c95134333

STYLE: suggest long names

Hopefully the exceptions are common sense.
---

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.