Re: [PATCH 01/29] coding-style.rst: Avoid comma statements

From: Joe Perches
Date: Sat Jan 30 2021 - 13:54:20 EST


On Mon, 2020-08-24 at 21:55 -0700, Joe Perches wrote:
> Commas are not how statements are terminated.
> Always use semicolons and braces if necessary.

ping?

>
> Signed-off-by: Joe Perches <joe@xxxxxxxxxxx>
> ---
>  Documentation/process/coding-style.rst | 17 +++++++++++++++++
>  1 file changed, 17 insertions(+)
>
> diff --git a/Documentation/process/coding-style.rst b/Documentation/process/coding-style.rst
> index 98227226c4e5..a1e061149e0d 100644
> --- a/Documentation/process/coding-style.rst
> +++ b/Documentation/process/coding-style.rst
> @@ -69,9 +69,26 @@ something to hide:
>   if (condition) do_this;
>   do_something_everytime;
>  
>
> +Don't use commas to avoid using braces:
> +
> +.. code-block:: c
> +
> + if (condition)
> + do_this(), do_that();
> +
> +Always uses braces for multiple statements:
> +
> +.. code-block:: c
> +
> + if (condition) {
> + do_this();
> + do_that();
> + }
> +
>  Don't put multiple assignments on a single line either. Kernel coding style
>  is super simple. Avoid tricky expressions.
>  
>
> +
>  Outside of comments, documentation and except in Kconfig, spaces are never
>  used for indentation, and the above example is deliberately broken.
>  
>