lkml.org 
[lkml]   [2019]   [Jun]   [20]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH 1/1] drivers/staging/rtl8129u: adjust block comments
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

\
 
 \ /
  Last update: 2019-06-20 13:34    [W:0.064 / U:1.332 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site