CODING: update style guide for multiline comments
[openafs.git] / CODING
diff --git a/CODING b/CODING
index 6a1af05..f8a3fd4 100644 (file)
--- a/CODING
+++ b/CODING
@@ -83,6 +83,16 @@ Suggested compiler flags:
                (You might not want the -fd, it isn't really useful, just complains about the
                K&R style functions, but -v gives useful info.)
 
+Multiple line comment blocks should begin with only /* on one line and end with
+only */ on one line.
+
+Example:
+
+       /*
+        * Multiple line comment blocks should be formatted
+        * like this example.
+        */
+
 \f
 Dependencies required to build OpenAFS from source
 --------------------------------------------------