Re: [PATCH 1/1] drivers/staging/rtl8129u: adjust block comments

From: Greg KH
Date: Thu Jun 20 2019 - 07:38:26 EST


On Thu, Jun 20, 2019 at 11:45:34AM +0200, Christian Müller wrote:
> As stated in coding-styles.rst multiline comments should be structured in a way,
> that the actual comment starts on the second line of the commented portion. E.g:
>
> /*
> * Multiline comments
> * should look like
> * this.
> */
>
> The comments in this file were of a format, that looked like this:
>
> /* Multiline comments previous
> * to this patch
> * looked like this.
> */
>
> There is an exception to files in /net and drivers/net,
> where multiline comments are preferred to look like the second example above,
> but since this file resides in a different directory,
> this patch changes the style to match the preferred style.

Ah. Hm. Turns out this is a networking driver, and some day, the goal
would be for it to live under drivers/net/ If it were to move there,
then these comments would be in the correct format already.

So this patch isn't needed, sorry.

greg k-h