Re: [PATCH v3] leds: trigger: Introduce a NETDEV trigger

From: Philippe Ombredanne
Date: Fri Dec 08 2017 - 09:33:10 EST


Pavel,

On Fri, Dec 8, 2017 at 3:27 PM, Pavel Machek <pavel@xxxxxx> wrote:
> On Thu 2017-12-07 14:01:39, Philippe Ombredanne wrote:
>> Ben,
>>
>> On Thu, Dec 7, 2017 at 12:46 PM, Ben Whitten <ben.whitten@xxxxxxxxx> wrote:
>> > From: Ben Whitten <ben.whitten@xxxxxxxxx>
>> >
>> > This commit introduces a NETDEV trigger for named device
>> > activity. Available triggers are link, rx, and tx.
>> >
>> > Signed-off-by: Ben Whitten <ben.whitten@xxxxxxxxx>
>> []
>> > --- /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 <ben.whitten@xxxxxxxxx>
>> > + *
>> > + * Copyright 2007 Oliver Jowett <oliver@xxxxxxxxxxxxx>
>> > + *
>> > + * Derived from ledtrig-timer.c which is:
>> > + * Copyright 2005-2006 Openedhand Ltd.
>> > + * Author: Richard Purdie <rpurdie@xxxxxxxxxxxxxx>
>> > + *
>> > + * 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 <ben.whitten@xxxxxxxxx>
>> > + *
>> > + * Copyright 2007 Oliver Jowett <oliver@xxxxxxxxxxxxx>
>> > + *
>> > + * Derived from ledtrig-timer.c which is:
>> > + * Copyright 2005-2006 Openedhand Ltd.
>> > + * Author: Richard Purdie <rpurdie@xxxxxxxxxxxxxx>
>> > + *
>> > + */
>>
>>
>> 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 <ben.whitten@xxxxxxxxx>
>> > +// Copyright 2007 Oliver Jowett <oliver@xxxxxxxxxxxxx>
>> > +/*
>> > + * 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 <rpurdie@xxxxxxxxxxxxxx>
>> > + *
>> > + */

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