Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752625AbdLMKCY (ORCPT ); Wed, 13 Dec 2017 05:02:24 -0500 Received: from mail-wm0-f44.google.com ([74.125.82.44]:46614 "EHLO mail-wm0-f44.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752473AbdLMKCV (ORCPT ); Wed, 13 Dec 2017 05:02:21 -0500 X-Google-Smtp-Source: ACJfBosjSqctZQ36fYSXdxn5FhcaqOluZncjoMGcgt3BBIiMgU72k4B0XToYfDQxbpI7tSsNnS3fxlL48lHtg40ze+k= MIME-Version: 1.0 In-Reply-To: References: <20171213082301.23209-1-dhaval.shah@softnautics.com> From: Philippe Ombredanne Date: Wed, 13 Dec 2017 11:01:39 +0100 Message-ID: Subject: Re: [PATCH] platform/x86: dell-rbtn: Block comments use * on subsequent lines To: Dhaval Shah Cc: "pali.rohar@gmail.com" , Darren Hart , Andy Shevchenko , "platform-driver-x86@vger.kernel.org" , LKML Content-Type: text/plain; charset="UTF-8" Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by nfs id vBDA2SqL024946 Content-Length: 3910 Lines: 94 Dhaval, On Wed, Dec 13, 2017 at 10:52 AM, Dhaval Shah wrote: > HI > > Thanks a lot for the review. > ________________________________________ >> From: Philippe Ombredanne >> Sent: Wednesday, December 13, 2017 2:54 PM >> To: Dhaval Shah >> Cc: pali.rohar@gmail.com; Darren Hart; Andy Shevchenko; platform-driver-x86@vger.kernel.org; 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 >> wrote: >> > Resolved Block comments use * on subsequent lines checkpatch warnings. >> > Issue found by checkpatch. >> > >> > Signed-off-by: Dhaval Shah >> > --- >> > 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 >> > - >> > - 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 >> > + * >> > + * 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 > */ 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 ... 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