]> xenbits.xensource.com Git - people/dwmw2/xen.git/commitdiff
CODING_STYLE: list further brace placement exceptions
authorJan Beulich <jbeulich@suse.com>
Mon, 5 Dec 2022 12:40:43 +0000 (13:40 +0100)
committerJan Beulich <jbeulich@suse.com>
Mon, 5 Dec 2022 12:40:43 +0000 (13:40 +0100)
For easy spotting of struct/union/enum definitions we already commonly
place the opening braces on the initial line of such a definition.

We also often don't place the opening brace of an initializer on a
separate line.

And finally for compound literals placing the braces on separate lines
often makes the code more difficult to read, so it should (and in
practice does) typically go on the same line as well.  The placement of
the closing brace often depends on how large such a compound literal is.

Signed-off-by: Jan Beulich <jbeulich@suse.com>
Acked-by: Stefano Stabellini <sstabellini@kernel.org>
CODING_STYLE

index 7d75debcbf09fc67a1d93be03a41ffb97845f60a..ced3ade5a6fb92ba98fe42773608d6cff6360f58 100644 (file)
@@ -80,8 +80,13 @@ Bracing
 -------
 
 Braces ('{' and '}') are usually placed on a line of their own, except
-for the do/while loop.  This is unlike the Linux coding style and
-unlike K&R.  do/while loops are an exception. e.g.:
+for
+- the do/while loop
+- the opening brace in definitions of enum, struct, and union
+- the opening brace in initializers
+- compound literals
+This is unlike the Linux coding style and unlike K&R.  do/while loops
+are one exception. e.g.:
 
 if ( condition )
 {