README.Coding: Add rule about function declaration indentation

[gd/samba-autobuild/.git] / README.Coding

diff --git a/README.Coding b/README.Coding
index 74dbc6eea66017751381d8992fb9661c6522624b..2bd7552f9fee594f8fa813119e969f03ed7627cd 100644 (file)
--- a/README.Coding
+++ b/README.Coding
@@ -191,6 +191,12 @@ parameters across lines and not as encourage for gratuitous line
 splitting.  Never split a line before columns 70 - 79 unless you
 have a really good reason. Be smart about formatting.
 
+One exception to the previous rule is function declarations and
+definitions. In function declarations and definitions, either the
+declaration is a one-liner, or each parameter is listed on its own
+line. The rationale is that if there are many parameters, each one
+should be on its own line to make tracking interface changes easier.
+
 
 If, switch, & Code blocks
 -------------------------