Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754117AbdLHOdI (ORCPT ); Fri, 8 Dec 2017 09:33:08 -0500 Received: from mail-wm0-f67.google.com ([74.125.82.67]:41509 "EHLO mail-wm0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753628AbdLHOdA (ORCPT ); Fri, 8 Dec 2017 09:33:00 -0500 X-Google-Smtp-Source: AGs4zMa57cldYEHw0nr5ayQrpDZVJDxH7jNtxI6QGGjTBN5X8hvxpp/JOE1ypXOwyLEF8VEWsTzL/zFr+q+DxLLOCV4= MIME-Version: 1.0 In-Reply-To: <20171208142707.GA7793@amd> References: <1512647169-11796-1-git-send-email-ben.whitten@lairdtech.com> <20171208142707.GA7793@amd> From: Philippe Ombredanne Date: Fri, 8 Dec 2017 15:32:18 +0100 Message-ID: Subject: Re: [PATCH v3] leds: trigger: Introduce a NETDEV trigger To: Pavel Machek Cc: Ben Whitten , rpurdie@rpsys.net, jacek.anaszewski@gmail.com, linux-leds@vger.kernel.org, LKML , netdev@vger.kernel.org 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-Length: 3129 Lines: 94 Pavel, On Fri, Dec 8, 2017 at 3:27 PM, Pavel Machek wrote: > On Thu 2017-12-07 14:01:39, Philippe Ombredanne wrote: >> Ben, >> >> On Thu, Dec 7, 2017 at 12:46 PM, Ben Whitten wrote: >> > From: Ben Whitten >> > >> > This commit introduces a NETDEV trigger for named device >> > activity. Available triggers are link, rx, and tx. >> > >> > Signed-off-by: Ben Whitten >> [] >> > --- /dev/null >> > +++ b/drivers/leds/trigger/ledtrig-netdev.c >> > @@ -0,0 +1,503 @@ >> > +/* >> > + * LED Kernel Netdev Trigger >> > + * >> > + * Toggles the LED to reflect the link and traffic state of a named net device >> > + * >> > + * Copyright 2017 Ben Whitten >> > + * >> > + * Copyright 2007 Oliver Jowett >> > + * >> > + * Derived from ledtrig-timer.c which is: >> > + * Copyright 2005-2006 Openedhand Ltd. >> > + * Author: Richard Purdie >> > + * >> > + * This program is free software; you can redistribute it and/or modify >> > + * it under the terms of the GNU General Public License version 2 as >> > + * published by the Free Software Foundation. >> > + * >> > + */ >> >> Have you considered using the new SPDX id instead ? See Thomas doc >> patches and Greg and Linus comments on the topic >> Here this would likely come out this way (yes, using a C++ comment at the top): >> >> > +// SPDX-License-Identifier: GPL-2.0 >> > +/* >> > + * LED Kernel Netdev Trigger >> > + * >> > + * Toggles the LED to reflect the link and traffic state of a named net device >> > + * >> > + * Copyright 2017 Ben Whitten >> > + * >> > + * Copyright 2007 Oliver Jowett >> > + * >> > + * Derived from ledtrig-timer.c which is: >> > + * Copyright 2005-2006 Openedhand Ltd. >> > + * Author: Richard Purdie >> > + * >> > + */ >> >> >> This is cleaner and simpler, don't you think? > > Please consider putting SPDX where it logically belongs -- near the > copyright. Linus wants it on the first line. So you could write this way alright: >> > +// SPDX-License-Identifier: GPL-2.0 >> > +// Copyright 2017 Ben Whitten >> > +// Copyright 2007 Oliver Jowett >> > +/* >> > + * LED Kernel Netdev Trigger >> > + * >> > + * Toggles the LED to reflect the link and traffic state of a named net device >> > + * >> > + * Derived from ledtrig-timer.c which is: >> > + * Copyright 2005-2006 Openedhand Ltd. >> > + * Author: Richard Purdie >> > + * >> > + */ For reference please check Linus [1][2][3], Thomas [4] and Greg [5] comments on the topic of C++ style // comments and first line placement. Jonathan also wrote a nice background article on the SPDXification topic at LWN [6] [1] https://lkml.org/lkml/2017/11/2/715 [2] https://lkml.org/lkml/2017/11/25/125 [3] https://lkml.org/lkml/2017/11/25/133 [4] https://lkml.org/lkml/2017/11/2/805 [5] https://lkml.org/lkml/2017/10/19/165 [6] https://lwn.net/Articles/739183/ -- Cordially Philippe Ombredanne