CodingStyle: Mention that "free" functions should accept a null pointer.

[sliver-openvswitch.git] / CodingStyle

diff --git a/CodingStyle b/CodingStyle
index bbb492e..2ee189f 100644 (file)
--- a/CodingStyle
+++ b/CodingStyle
@@ -156,6 +156,12 @@ parameters and their corresponding size parameters should be paired.
         ...
     }
 
+Functions that destroy an instance of a dynamically-allocated type
+should accept and ignore a null pointer argument.  Code that calls
+such a function (including the C standard library function free())
+should omit a null-pointer check.  We find that this usually makes
+code easier to read.
+
 
 FUNCTION PROTOTYPES