Provide "ident" command line (at least the start of one)
[asterisk/asterisk.git] / doc / CODING-GUIDELINES
index 04b5b38..643e544 100755 (executable)
@@ -24,6 +24,11 @@ Try to match the existing formatting of the file you are working on.
 Functions and variables that are not intended to be global must be
 declared static.
 
+Roughly, Asterisk coding guidelines are generally equivalent to the 
+following:
+
+# indent -i4 -ts4 -br -brs -cdw -cli0 -ce -nbfda -npcs -npsl foo.c
+
 Function calls and arguments should be spaced in a consistent way across
 the codebase.
 GOOD: foo(arg1, arg2);
@@ -49,10 +54,25 @@ if (foo) {
 
 Case statements:
 switch (foo) {
-       case BAR:
-               blah();
-               break;
-       case OTHER:
-               other();
-               break;
+case BAR:
+       blah();
+       break;
+case OTHER:
+       other();
+       break;
+}
+
+No nested statements without braces, e.g. no:
+
+for (x=0;x<5;x++)
+       if (foo) 
+               if (bar)
+                       baz();
+
+instead do:
+for (x=0;x<5;x++) {
+       if (foo) {
+               if (bar)
+                       baz();
+       }
 }