Re: Please fix or revert: [PATCH] checkpatch: add --strict tests forbraces, comments and casts

From: Linus Torvalds
Date: Mon Apr 16 2012 - 15:09:32 EST


On Mon, Apr 16, 2012 at 11:27 AM, David Miller <davem@xxxxxxxxxxxxx> wrote:
>
> I would like to formally propose that we change CodingStyle so that
> our comments are of the form:
>
>        /* XXX
>         * YYY
>         */
>
> So that we can save one line of vertical space.

Ugh, I personally hate it. No way will we make that the recommended
version, even if it might be an acceptable substitute in some
subsystems.

It looks unbalanced. If you want to save that vertical space, just use
C++ style comments instead, for chissake! Then you save *two* lines,
without the unbalanced thing, and just write it as

// XXX
// YYY

which is much preferred.

Your suggested format just sucks, and has the worst of all worlds.

Linus
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/