libxl/CODING_STYLE: Clarify the singular statement in a conditional statement explana...
authorKonrad Rzeszutek Wilk <konrad.wilk@oracle.com>
Fri, 1 Apr 2016 15:13:57 +0000 (11:13 -0400)
committerIan Jackson <Ian.Jackson@eu.citrix.com>
Wed, 6 Apr 2016 13:53:31 +0000 (14:53 +0100)
It takes a bit of thinking to parse the original statement. It looks
like it is missing an ',' - right after the 'braced' to make it
obvious that:

if (X)
   return XYZ;

is OK, while multiple conditionals require braces.

Changing the 'apart from' with 'except' makes it more obvious
(I hope).

Signed-off-by: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>
tools/libxl/CODING_STYLE

index 522d1c98b4a021628c038fcdd7b8a6564f480899..01ee25b392a187e71268cc3bda348c16344c4526 100644 (file)
@@ -294,7 +294,7 @@ Libxenlight coding style is super simple.  Avoid tricky expressions.
 
 5. Block structure
 
-Every indented statement is braced apart from blocks that contain just
+Every indented statement is braced, except blocks that contain just
 one statement.
 The opening brace is on the line that contains the control flow
 statement that introduces the new block; the closing brace is on the