Re: [PATCH] platform/x86: dell-rbtn: Block comments use * on subsequent lines

[Philippe Ombredanne]

Dhaval,

On Wed, Dec 13, 2017 at 10:52 AM, Dhaval Shah
<dhaval.shah@xxxxxxxxxxxxxxx> wrote:
> HI
>
> Thanks a lot for the review.
> ________________________________________
>> From: Philippe Ombredanne <pombredanne@xxxxxxxx>
>> Sent: Wednesday, December 13, 2017 2:54 PM
>> To: Dhaval Shah
>> Cc: pali.rohar@xxxxxxxxx; Darren Hart; Andy Shevchenko; platform-driver-x86@xxxxxxxxxxxxxxx; LKML
>> Subject: Re: [PATCH] platform/x86: dell-rbtn: Block comments use * on subsequent lines
>>
>> Dhaval,
>>
>> On Wed, Dec 13, 2017 at 9:23 AM, Dhaval Shah
>> <dhaval.shah@xxxxxxxxxxxxxxx> wrote:
>> > Resolved Block comments use * on subsequent lines checkpatch warnings.
>> > Issue found by checkpatch.
>> >
>> > Signed-off-by: Dhaval Shah <dhaval.shah@xxxxxxxxxxxxxxx>
>> > ---
>> >  drivers/platform/x86/dell-rbtn.c | 26 +++++++++++++-------------
>> >  drivers/platform/x86/dell-rbtn.h | 26 +++++++++++++-------------
>> >  2 files changed, 26 insertions(+), 26 deletions(-)
>> >
>> > diff --git a/drivers/platform/x86/dell-rbtn.c b/drivers/platform/x86/dell-rbtn.c
>> > index f3afe778001e..cab93c6dcd34 100644
>> > --- a/drivers/platform/x86/dell-rbtn.c
>> > +++ b/drivers/platform/x86/dell-rbtn.c
>> > @@ -1,17 +1,17 @@
>> >  /*
>> > -    Dell Airplane Mode Switch driver
>> > -    Copyright (C) 2014-2015  Pali RohÃr <pali.rohar@xxxxxxxxx>
>> > -
>> > -    This program is free software; you can redistribute it and/or modify
>> > -    it under the terms of the GNU General Public License as published by
>> > -    the Free Software Foundation; either version 2 of the License, or
>> > -    (at your option) any later version.
>> > -
>> > -    This program is distributed in the hope that it will be useful,
>> > -    but WITHOUT ANY WARRANTY; without even the implied warranty of
>> > -    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
>> > -    GNU General Public License for more details.
>> > -*/
>> > + *   Dell Airplane Mode Switch driver
>> > + *   Copyright (C) 2014-2015  Pali RohÃr <pali.rohar@xxxxxxxxx>
>> > + *
>> > + *   This program is free software; you can redistribute it and/or modify
>> > + *   it under the terms of the GNU General Public License as published by
>> > + *   the Free Software Foundation; either version 2 of the License, or
>> > + *   (at your option) any later version.
>> > + *
>> > + *   This program is distributed in the hope that it will be useful,
>> > + *   but WITHOUT ANY WARRANTY; without even the implied warranty of
>> > + *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
>> > + *   GNU General Public License for more details.
>> > + */
>>
>> Do you mind using the new SPDX ids instead of this long legalese?
>> You can check the doc patches from Thomas for details [1]
>>
>>
>> [1] https://lkml.org/lkml/2017/12/4/934
> This is different issue. If we need to fix the issue of this if we update SPDX licensing as well.
> I am agree with you on the use of the new SPDX IDs instead of the long legalese.
> For this, we have to add the text "// SPDX-License-Identifier: GPL-2.0" at the top of the file and remove the
> whole license part and keep on copyright and Author name related info. After change, it looks like
> // SPDX-License-Identifier: GPL-2.0
> /*
>  *  Dell Airplane Mode Switch driver
>  *  Copyright (C) 2014-2015  Pali RohÃr <pali.rohar@xxxxxxxxx>
>  */

And for a short comment block like this, Linus preference is to avoid
mixing comment style and go all the way C++ style as in:

> // SPDX-License-Identifier: GPL-2.0
> // Dell Airplane Mode Switch driver
> // Copyright (C) 2014-2015  Pali RohÃr <pali.rohar@xxxxxxxxx>

... for even less boilerplate ;)

See Linus comments for a rationale [1] [2] [3] [4] [5]

[1] https://lkml.org/lkml/2017/11/25/133
[2] https://lkml.org/lkml/2017/11/25/125
[3] https://lkml.org/lkml/2017/11/2/715
[4] https://lkml.org/lkml/2017/11/2/805

-- 
Cordially
Philippe Ombredanne