Browse Source

CodingGuidelines: style for multi-line comments

The style for multi-line comments is often mentioned and should be documented
for clarity.

Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
maint
brian m. carlson 11 years ago committed by Jonathan Nieder
parent
commit
b75a6ca7f3
  1. 8
      Documentation/CodingGuidelines

8
Documentation/CodingGuidelines

@ -145,6 +145,14 @@ For C programs: @@ -145,6 +145,14 @@ For C programs:
they were describing changes. Often splitting a function
into two makes the intention of the code much clearer.

- Multi-line comments include their delimiters on separate lines from
the text. E.g.

/*
* A very long
* multi-line comment.
*/

- Double negation is often harder to understand than no negation
at all.


Loading…
Cancel
Save