All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-01  7:07 ` Nishad Kamdar
  0 siblings, 0 replies; 15+ messages in thread
From: Nishad Kamdar @ 2019-05-01  7:07 UTC (permalink / raw)
  To: Andreas Färber, Manivannan Sadhasivam, Michael Turquette,
	Stephen Boyd
  Cc: Greg Kroah-Hartman, Joe Perches, Uwe Kleine-König,
	linux-arm-kernel, linux-clk, linux-kernel

This patch corrects the SPDX License Identifier style
in header files related to Clock Drivers for Actions Semi Socs.
For C header files Documentation/process/license-rules.rst
mandates C-like comments (opposed to C source files where
C++ style should be used)

Changes made by using a script provided by Joe Perches here:
https://lkml.org/lkml/2019/2/7/46

Suggested-by: Joe Perches <joe@perches.com>
Signed-off-by: Nishad Kamdar <nishadkamdar@gmail.com>
---
 drivers/clk/actions/owl-common.h       | 2 +-
 drivers/clk/actions/owl-composite.h    | 2 +-
 drivers/clk/actions/owl-divider.h      | 2 +-
 drivers/clk/actions/owl-factor.h       | 2 +-
 drivers/clk/actions/owl-fixed-factor.h | 2 +-
 drivers/clk/actions/owl-gate.h         | 2 +-
 drivers/clk/actions/owl-mux.h          | 2 +-
 drivers/clk/actions/owl-pll.h          | 2 +-
 drivers/clk/actions/owl-reset.h        | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/drivers/clk/actions/owl-common.h b/drivers/clk/actions/owl-common.h
index 5a866a8b913d..c000a431471e 100644
--- a/drivers/clk/actions/owl-common.h
+++ b/drivers/clk/actions/owl-common.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL common clock driver
 //
diff --git a/drivers/clk/actions/owl-composite.h b/drivers/clk/actions/owl-composite.h
index b410ed5bf308..bca38bf8f218 100644
--- a/drivers/clk/actions/owl-composite.h
+++ b/drivers/clk/actions/owl-composite.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL composite clock driver
 //
diff --git a/drivers/clk/actions/owl-divider.h b/drivers/clk/actions/owl-divider.h
index 92d3e3d23967..083be6d80954 100644
--- a/drivers/clk/actions/owl-divider.h
+++ b/drivers/clk/actions/owl-divider.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL divider clock driver
 //
diff --git a/drivers/clk/actions/owl-factor.h b/drivers/clk/actions/owl-factor.h
index f1a7ffe896e1..04b89cbfdccb 100644
--- a/drivers/clk/actions/owl-factor.h
+++ b/drivers/clk/actions/owl-factor.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL factor clock driver
 //
diff --git a/drivers/clk/actions/owl-fixed-factor.h b/drivers/clk/actions/owl-fixed-factor.h
index cc9fe36c0964..3dfd7fd7d292 100644
--- a/drivers/clk/actions/owl-fixed-factor.h
+++ b/drivers/clk/actions/owl-fixed-factor.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL fixed factor clock driver
 //
diff --git a/drivers/clk/actions/owl-gate.h b/drivers/clk/actions/owl-gate.h
index c2d61ceebce2..c2f161c93fda 100644
--- a/drivers/clk/actions/owl-gate.h
+++ b/drivers/clk/actions/owl-gate.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL gate clock driver
 //
diff --git a/drivers/clk/actions/owl-mux.h b/drivers/clk/actions/owl-mux.h
index 834284c8c3ae..53b9ab665294 100644
--- a/drivers/clk/actions/owl-mux.h
+++ b/drivers/clk/actions/owl-mux.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL mux clock driver
 //
diff --git a/drivers/clk/actions/owl-pll.h b/drivers/clk/actions/owl-pll.h
index 6fb0d45bb088..78e5fc360b03 100644
--- a/drivers/clk/actions/owl-pll.h
+++ b/drivers/clk/actions/owl-pll.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL pll clock driver
 //
diff --git a/drivers/clk/actions/owl-reset.h b/drivers/clk/actions/owl-reset.h
index 10f5774979a6..a947ffcb5a02 100644
--- a/drivers/clk/actions/owl-reset.h
+++ b/drivers/clk/actions/owl-reset.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0-or-later
+/* SPDX-License-Identifier: GPL-2.0-or-later */
 //
 // Actions Semi Owl SoCs Reset Management Unit driver
 //
-- 
2.17.1


^ permalink raw reply related	[flat|nested] 15+ messages in thread

* [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-01  7:07 ` Nishad Kamdar
  0 siblings, 0 replies; 15+ messages in thread
From: Nishad Kamdar @ 2019-05-01  7:07 UTC (permalink / raw)
  To: Andreas Färber, Manivannan Sadhasivam, Michael Turquette,
	Stephen Boyd
  Cc: Greg Kroah-Hartman, linux-kernel, Uwe Kleine-König,
	Joe Perches, linux-clk, linux-arm-kernel

This patch corrects the SPDX License Identifier style
in header files related to Clock Drivers for Actions Semi Socs.
For C header files Documentation/process/license-rules.rst
mandates C-like comments (opposed to C source files where
C++ style should be used)

Changes made by using a script provided by Joe Perches here:
https://lkml.org/lkml/2019/2/7/46

Suggested-by: Joe Perches <joe@perches.com>
Signed-off-by: Nishad Kamdar <nishadkamdar@gmail.com>
---
 drivers/clk/actions/owl-common.h       | 2 +-
 drivers/clk/actions/owl-composite.h    | 2 +-
 drivers/clk/actions/owl-divider.h      | 2 +-
 drivers/clk/actions/owl-factor.h       | 2 +-
 drivers/clk/actions/owl-fixed-factor.h | 2 +-
 drivers/clk/actions/owl-gate.h         | 2 +-
 drivers/clk/actions/owl-mux.h          | 2 +-
 drivers/clk/actions/owl-pll.h          | 2 +-
 drivers/clk/actions/owl-reset.h        | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/drivers/clk/actions/owl-common.h b/drivers/clk/actions/owl-common.h
index 5a866a8b913d..c000a431471e 100644
--- a/drivers/clk/actions/owl-common.h
+++ b/drivers/clk/actions/owl-common.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL common clock driver
 //
diff --git a/drivers/clk/actions/owl-composite.h b/drivers/clk/actions/owl-composite.h
index b410ed5bf308..bca38bf8f218 100644
--- a/drivers/clk/actions/owl-composite.h
+++ b/drivers/clk/actions/owl-composite.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL composite clock driver
 //
diff --git a/drivers/clk/actions/owl-divider.h b/drivers/clk/actions/owl-divider.h
index 92d3e3d23967..083be6d80954 100644
--- a/drivers/clk/actions/owl-divider.h
+++ b/drivers/clk/actions/owl-divider.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL divider clock driver
 //
diff --git a/drivers/clk/actions/owl-factor.h b/drivers/clk/actions/owl-factor.h
index f1a7ffe896e1..04b89cbfdccb 100644
--- a/drivers/clk/actions/owl-factor.h
+++ b/drivers/clk/actions/owl-factor.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL factor clock driver
 //
diff --git a/drivers/clk/actions/owl-fixed-factor.h b/drivers/clk/actions/owl-fixed-factor.h
index cc9fe36c0964..3dfd7fd7d292 100644
--- a/drivers/clk/actions/owl-fixed-factor.h
+++ b/drivers/clk/actions/owl-fixed-factor.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL fixed factor clock driver
 //
diff --git a/drivers/clk/actions/owl-gate.h b/drivers/clk/actions/owl-gate.h
index c2d61ceebce2..c2f161c93fda 100644
--- a/drivers/clk/actions/owl-gate.h
+++ b/drivers/clk/actions/owl-gate.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL gate clock driver
 //
diff --git a/drivers/clk/actions/owl-mux.h b/drivers/clk/actions/owl-mux.h
index 834284c8c3ae..53b9ab665294 100644
--- a/drivers/clk/actions/owl-mux.h
+++ b/drivers/clk/actions/owl-mux.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL mux clock driver
 //
diff --git a/drivers/clk/actions/owl-pll.h b/drivers/clk/actions/owl-pll.h
index 6fb0d45bb088..78e5fc360b03 100644
--- a/drivers/clk/actions/owl-pll.h
+++ b/drivers/clk/actions/owl-pll.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0+
+/* SPDX-License-Identifier: GPL-2.0+ */
 //
 // OWL pll clock driver
 //
diff --git a/drivers/clk/actions/owl-reset.h b/drivers/clk/actions/owl-reset.h
index 10f5774979a6..a947ffcb5a02 100644
--- a/drivers/clk/actions/owl-reset.h
+++ b/drivers/clk/actions/owl-reset.h
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: GPL-2.0-or-later
+/* SPDX-License-Identifier: GPL-2.0-or-later */
 //
 // Actions Semi Owl SoCs Reset Management Unit driver
 //
-- 
2.17.1


_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply related	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
  2019-05-01  7:07 ` Nishad Kamdar
  (?)
@ 2019-05-01 20:02 ` Stephen Boyd
  -1 siblings, 0 replies; 15+ messages in thread
From: Stephen Boyd @ 2019-05-01 20:02 UTC (permalink / raw)
  To: Andreas Färber, Manivannan Sadhasivam, Michael Turquette,
	Nishad Kamdar
  Cc: Greg Kroah-Hartman, linux-kernel, Uwe Kleine-König,
	Joe Perches, linux-clk, linux-arm-kernel

Quoting Nishad Kamdar (2019-05-01 00:07:11)
> This patch corrects the SPDX License Identifier style
> in header files related to Clock Drivers for Actions Semi Socs.
> For C header files Documentation/process/license-rules.rst
> mandates C-like comments (opposed to C source files where
> C++ style should be used)
> 
> Changes made by using a script provided by Joe Perches here:
> https://lkml.org/lkml/2019/2/7/46
> 
> Suggested-by: Joe Perches <joe@perches.com>
> Signed-off-by: Nishad Kamdar <nishadkamdar@gmail.com>
> ---

Applied to clk-next


_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
  2019-05-01  7:07 ` Nishad Kamdar
@ 2019-05-01 20:20   ` Andreas Färber
  -1 siblings, 0 replies; 15+ messages in thread
From: Andreas Färber @ 2019-05-01 20:20 UTC (permalink / raw)
  To: Nishad Kamdar
  Cc: Manivannan Sadhasivam, Michael Turquette, Stephen Boyd,
	Greg Kroah-Hartman, Joe Perches, Uwe Kleine-König,
	linux-arm-kernel, linux-clk, linux-kernel, linux-actions

+ linux-actions

Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> This patch corrects the SPDX License Identifier style
> in header files related to Clock Drivers for Actions Semi Socs.
> For C header files Documentation/process/license-rules.rst
> mandates C-like comments (opposed to C source files where
> C++ style should be used)
[...]
>  drivers/clk/actions/owl-common.h       | 2 +-
>  drivers/clk/actions/owl-composite.h    | 2 +-
>  drivers/clk/actions/owl-divider.h      | 2 +-
>  drivers/clk/actions/owl-factor.h       | 2 +-
>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
>  drivers/clk/actions/owl-gate.h         | 2 +-
>  drivers/clk/actions/owl-mux.h          | 2 +-
>  drivers/clk/actions/owl-pll.h          | 2 +-
>  drivers/clk/actions/owl-reset.h        | 2 +-
>  9 files changed, 9 insertions(+), 9 deletions(-)

Where's the practical benefit of this patch? These are all private
headers used from C files, so they can handle C++ comments just fine,
otherwise we would've seen build failures.

I could understand if you were patching files in include/ but not here.

Regards,
Andreas

-- 
SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
HRB 21284 (AG Nürnberg)

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-01 20:20   ` Andreas Färber
  0 siblings, 0 replies; 15+ messages in thread
From: Andreas Färber @ 2019-05-01 20:20 UTC (permalink / raw)
  To: Nishad Kamdar
  Cc: Stephen Boyd, Greg Kroah-Hartman, Michael Turquette,
	Manivannan Sadhasivam, linux-actions, linux-kernel,
	Uwe Kleine-König, Joe Perches, linux-clk, linux-arm-kernel

+ linux-actions

Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> This patch corrects the SPDX License Identifier style
> in header files related to Clock Drivers for Actions Semi Socs.
> For C header files Documentation/process/license-rules.rst
> mandates C-like comments (opposed to C source files where
> C++ style should be used)
[...]
>  drivers/clk/actions/owl-common.h       | 2 +-
>  drivers/clk/actions/owl-composite.h    | 2 +-
>  drivers/clk/actions/owl-divider.h      | 2 +-
>  drivers/clk/actions/owl-factor.h       | 2 +-
>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
>  drivers/clk/actions/owl-gate.h         | 2 +-
>  drivers/clk/actions/owl-mux.h          | 2 +-
>  drivers/clk/actions/owl-pll.h          | 2 +-
>  drivers/clk/actions/owl-reset.h        | 2 +-
>  9 files changed, 9 insertions(+), 9 deletions(-)

Where's the practical benefit of this patch? These are all private
headers used from C files, so they can handle C++ comments just fine,
otherwise we would've seen build failures.

I could understand if you were patching files in include/ but not here.

Regards,
Andreas

-- 
SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
HRB 21284 (AG Nürnberg)

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
  2019-05-01 20:20   ` Andreas Färber
@ 2019-05-02  7:07     ` Greg Kroah-Hartman
  -1 siblings, 0 replies; 15+ messages in thread
From: Greg Kroah-Hartman @ 2019-05-02  7:07 UTC (permalink / raw)
  To: Andreas Färber
  Cc: Nishad Kamdar, Manivannan Sadhasivam, Michael Turquette,
	Stephen Boyd, Joe Perches, Uwe Kleine-König,
	linux-arm-kernel, linux-clk, linux-kernel, linux-actions

On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
> + linux-actions
> 
> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> > This patch corrects the SPDX License Identifier style
> > in header files related to Clock Drivers for Actions Semi Socs.
> > For C header files Documentation/process/license-rules.rst
> > mandates C-like comments (opposed to C source files where
> > C++ style should be used)
> [...]
> >  drivers/clk/actions/owl-common.h       | 2 +-
> >  drivers/clk/actions/owl-composite.h    | 2 +-
> >  drivers/clk/actions/owl-divider.h      | 2 +-
> >  drivers/clk/actions/owl-factor.h       | 2 +-
> >  drivers/clk/actions/owl-fixed-factor.h | 2 +-
> >  drivers/clk/actions/owl-gate.h         | 2 +-
> >  drivers/clk/actions/owl-mux.h          | 2 +-
> >  drivers/clk/actions/owl-pll.h          | 2 +-
> >  drivers/clk/actions/owl-reset.h        | 2 +-
> >  9 files changed, 9 insertions(+), 9 deletions(-)
> 
> Where's the practical benefit of this patch? These are all private
> headers used from C files, so they can handle C++ comments just fine,
> otherwise we would've seen build failures.

Please read Documentation/process/license-rules.rst, the section
entitled "Style", for what the documented formats are for SPDX lines,
depending on the file type.

thanks,

greg k-h

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-02  7:07     ` Greg Kroah-Hartman
  0 siblings, 0 replies; 15+ messages in thread
From: Greg Kroah-Hartman @ 2019-05-02  7:07 UTC (permalink / raw)
  To: Andreas Färber
  Cc: Nishad Kamdar, Stephen Boyd, Michael Turquette,
	Manivannan Sadhasivam, linux-actions, linux-kernel,
	Uwe Kleine-König, Joe Perches, linux-clk, linux-arm-kernel

On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
> + linux-actions
> 
> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> > This patch corrects the SPDX License Identifier style
> > in header files related to Clock Drivers for Actions Semi Socs.
> > For C header files Documentation/process/license-rules.rst
> > mandates C-like comments (opposed to C source files where
> > C++ style should be used)
> [...]
> >  drivers/clk/actions/owl-common.h       | 2 +-
> >  drivers/clk/actions/owl-composite.h    | 2 +-
> >  drivers/clk/actions/owl-divider.h      | 2 +-
> >  drivers/clk/actions/owl-factor.h       | 2 +-
> >  drivers/clk/actions/owl-fixed-factor.h | 2 +-
> >  drivers/clk/actions/owl-gate.h         | 2 +-
> >  drivers/clk/actions/owl-mux.h          | 2 +-
> >  drivers/clk/actions/owl-pll.h          | 2 +-
> >  drivers/clk/actions/owl-reset.h        | 2 +-
> >  9 files changed, 9 insertions(+), 9 deletions(-)
> 
> Where's the practical benefit of this patch? These are all private
> headers used from C files, so they can handle C++ comments just fine,
> otherwise we would've seen build failures.

Please read Documentation/process/license-rules.rst, the section
entitled "Style", for what the documented formats are for SPDX lines,
depending on the file type.

thanks,

greg k-h

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
  2019-05-02  7:07     ` Greg Kroah-Hartman
@ 2019-05-02 10:25       ` Andreas Färber
  -1 siblings, 0 replies; 15+ messages in thread
From: Andreas Färber @ 2019-05-02 10:25 UTC (permalink / raw)
  To: Greg Kroah-Hartman
  Cc: Nishad Kamdar, Manivannan Sadhasivam, Michael Turquette,
	Stephen Boyd, Joe Perches, Uwe Kleine-König,
	linux-arm-kernel, linux-clk, linux-kernel, linux-actions

Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
> On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
>> + linux-actions
>>
>> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
>>> This patch corrects the SPDX License Identifier style
>>> in header files related to Clock Drivers for Actions Semi Socs.
>>> For C header files Documentation/process/license-rules.rst
>>> mandates C-like comments (opposed to C source files where
>>> C++ style should be used)
>> [...]
>>>  drivers/clk/actions/owl-common.h       | 2 +-
>>>  drivers/clk/actions/owl-composite.h    | 2 +-
>>>  drivers/clk/actions/owl-divider.h      | 2 +-
>>>  drivers/clk/actions/owl-factor.h       | 2 +-
>>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
>>>  drivers/clk/actions/owl-gate.h         | 2 +-
>>>  drivers/clk/actions/owl-mux.h          | 2 +-
>>>  drivers/clk/actions/owl-pll.h          | 2 +-
>>>  drivers/clk/actions/owl-reset.h        | 2 +-
>>>  9 files changed, 9 insertions(+), 9 deletions(-)
>>
>> Where's the practical benefit of this patch? These are all private
>> headers used from C files, so they can handle C++ comments just fine,
>> otherwise we would've seen build failures.
> 
> Please read Documentation/process/license-rules.rst, the section
> entitled "Style", for what the documented formats are for SPDX lines,
> depending on the file type.

That does in no way answer my question! You conveniently dropped my
paragraph indicating that I understand why we would do that for public
headers in include/, but none of these private headers here are included
in .lds files. So there really seems to be no benefit of switching from
one style to another for in-tree code.

Regards,
Andreas

-- 
SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
HRB 21284 (AG Nürnberg)

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-02 10:25       ` Andreas Färber
  0 siblings, 0 replies; 15+ messages in thread
From: Andreas Färber @ 2019-05-02 10:25 UTC (permalink / raw)
  To: Greg Kroah-Hartman
  Cc: Nishad Kamdar, Stephen Boyd, Michael Turquette,
	Manivannan Sadhasivam, linux-actions, linux-kernel,
	Uwe Kleine-König, Joe Perches, linux-clk, linux-arm-kernel

Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
> On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
>> + linux-actions
>>
>> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
>>> This patch corrects the SPDX License Identifier style
>>> in header files related to Clock Drivers for Actions Semi Socs.
>>> For C header files Documentation/process/license-rules.rst
>>> mandates C-like comments (opposed to C source files where
>>> C++ style should be used)
>> [...]
>>>  drivers/clk/actions/owl-common.h       | 2 +-
>>>  drivers/clk/actions/owl-composite.h    | 2 +-
>>>  drivers/clk/actions/owl-divider.h      | 2 +-
>>>  drivers/clk/actions/owl-factor.h       | 2 +-
>>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
>>>  drivers/clk/actions/owl-gate.h         | 2 +-
>>>  drivers/clk/actions/owl-mux.h          | 2 +-
>>>  drivers/clk/actions/owl-pll.h          | 2 +-
>>>  drivers/clk/actions/owl-reset.h        | 2 +-
>>>  9 files changed, 9 insertions(+), 9 deletions(-)
>>
>> Where's the practical benefit of this patch? These are all private
>> headers used from C files, so they can handle C++ comments just fine,
>> otherwise we would've seen build failures.
> 
> Please read Documentation/process/license-rules.rst, the section
> entitled "Style", for what the documented formats are for SPDX lines,
> depending on the file type.

That does in no way answer my question! You conveniently dropped my
paragraph indicating that I understand why we would do that for public
headers in include/, but none of these private headers here are included
in .lds files. So there really seems to be no benefit of switching from
one style to another for in-tree code.

Regards,
Andreas

-- 
SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
HRB 21284 (AG Nürnberg)

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
  2019-05-02 10:25       ` Andreas Färber
@ 2019-05-02 10:38         ` Greg Kroah-Hartman
  -1 siblings, 0 replies; 15+ messages in thread
From: Greg Kroah-Hartman @ 2019-05-02 10:38 UTC (permalink / raw)
  To: Andreas Färber
  Cc: Nishad Kamdar, Manivannan Sadhasivam, Michael Turquette,
	Stephen Boyd, Joe Perches, Uwe Kleine-König,
	linux-arm-kernel, linux-clk, linux-kernel, linux-actions

On Thu, May 02, 2019 at 12:25:36PM +0200, Andreas Färber wrote:
> Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
> > On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
> >> + linux-actions
> >>
> >> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> >>> This patch corrects the SPDX License Identifier style
> >>> in header files related to Clock Drivers for Actions Semi Socs.
> >>> For C header files Documentation/process/license-rules.rst
> >>> mandates C-like comments (opposed to C source files where
> >>> C++ style should be used)
> >> [...]
> >>>  drivers/clk/actions/owl-common.h       | 2 +-
> >>>  drivers/clk/actions/owl-composite.h    | 2 +-
> >>>  drivers/clk/actions/owl-divider.h      | 2 +-
> >>>  drivers/clk/actions/owl-factor.h       | 2 +-
> >>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
> >>>  drivers/clk/actions/owl-gate.h         | 2 +-
> >>>  drivers/clk/actions/owl-mux.h          | 2 +-
> >>>  drivers/clk/actions/owl-pll.h          | 2 +-
> >>>  drivers/clk/actions/owl-reset.h        | 2 +-
> >>>  9 files changed, 9 insertions(+), 9 deletions(-)
> >>
> >> Where's the practical benefit of this patch? These are all private
> >> headers used from C files, so they can handle C++ comments just fine,
> >> otherwise we would've seen build failures.
> > 
> > Please read Documentation/process/license-rules.rst, the section
> > entitled "Style", for what the documented formats are for SPDX lines,
> > depending on the file type.
> 
> That does in no way answer my question! You conveniently dropped my
> paragraph indicating that I understand why we would do that for public
> headers in include/, but none of these private headers here are included
> in .lds files. So there really seems to be no benefit of switching from
> one style to another for in-tree code.

It should answer the question, it was "decreed" that all header files
use /* */, and all C files use // for their SPDX lines, so we documented
it that way.

Yes, maybe it doesn't make "sense" in that this really is only needed
for headers that get included into asm files, which is why we had to do
it this way, but it's better to be consistant than to have random
breakages at times.

It's not an issue of public headers at all, sorry.

Consistency is good, as we can have automatic tools check these types of
things, which is the only way to reliably handle the format of something
that needs to be in every file in a project with 63,100+ different
files.

thanks,

greg k-h
> 
> Regards,
> Andreas
> 
> -- 
> SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
> GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
> HRB 21284 (AG Nürnberg)

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-02 10:38         ` Greg Kroah-Hartman
  0 siblings, 0 replies; 15+ messages in thread
From: Greg Kroah-Hartman @ 2019-05-02 10:38 UTC (permalink / raw)
  To: Andreas Färber
  Cc: Nishad Kamdar, Stephen Boyd, Michael Turquette,
	Manivannan Sadhasivam, linux-actions, linux-kernel,
	Uwe Kleine-König, Joe Perches, linux-clk, linux-arm-kernel

On Thu, May 02, 2019 at 12:25:36PM +0200, Andreas Färber wrote:
> Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
> > On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
> >> + linux-actions
> >>
> >> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> >>> This patch corrects the SPDX License Identifier style
> >>> in header files related to Clock Drivers for Actions Semi Socs.
> >>> For C header files Documentation/process/license-rules.rst
> >>> mandates C-like comments (opposed to C source files where
> >>> C++ style should be used)
> >> [...]
> >>>  drivers/clk/actions/owl-common.h       | 2 +-
> >>>  drivers/clk/actions/owl-composite.h    | 2 +-
> >>>  drivers/clk/actions/owl-divider.h      | 2 +-
> >>>  drivers/clk/actions/owl-factor.h       | 2 +-
> >>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
> >>>  drivers/clk/actions/owl-gate.h         | 2 +-
> >>>  drivers/clk/actions/owl-mux.h          | 2 +-
> >>>  drivers/clk/actions/owl-pll.h          | 2 +-
> >>>  drivers/clk/actions/owl-reset.h        | 2 +-
> >>>  9 files changed, 9 insertions(+), 9 deletions(-)
> >>
> >> Where's the practical benefit of this patch? These are all private
> >> headers used from C files, so they can handle C++ comments just fine,
> >> otherwise we would've seen build failures.
> > 
> > Please read Documentation/process/license-rules.rst, the section
> > entitled "Style", for what the documented formats are for SPDX lines,
> > depending on the file type.
> 
> That does in no way answer my question! You conveniently dropped my
> paragraph indicating that I understand why we would do that for public
> headers in include/, but none of these private headers here are included
> in .lds files. So there really seems to be no benefit of switching from
> one style to another for in-tree code.

It should answer the question, it was "decreed" that all header files
use /* */, and all C files use // for their SPDX lines, so we documented
it that way.

Yes, maybe it doesn't make "sense" in that this really is only needed
for headers that get included into asm files, which is why we had to do
it this way, but it's better to be consistant than to have random
breakages at times.

It's not an issue of public headers at all, sorry.

Consistency is good, as we can have automatic tools check these types of
things, which is the only way to reliably handle the format of something
that needs to be in every file in a project with 63,100+ different
files.

thanks,

greg k-h
> 
> Regards,
> Andreas
> 
> -- 
> SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
> GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
> HRB 21284 (AG Nürnberg)

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
  2019-05-02 10:38         ` Greg Kroah-Hartman
@ 2019-05-02 10:45           ` Andreas Färber
  -1 siblings, 0 replies; 15+ messages in thread
From: Andreas Färber @ 2019-05-02 10:45 UTC (permalink / raw)
  To: Greg Kroah-Hartman
  Cc: Nishad Kamdar, Manivannan Sadhasivam, Michael Turquette,
	Stephen Boyd, Joe Perches, Uwe Kleine-König,
	linux-arm-kernel, linux-clk, linux-kernel, linux-actions

Am 02.05.19 um 12:38 schrieb Greg Kroah-Hartman:
> On Thu, May 02, 2019 at 12:25:36PM +0200, Andreas Färber wrote:
>> Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
>>> On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
>>>> + linux-actions
>>>>
>>>> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
>>>>> This patch corrects the SPDX License Identifier style
>>>>> in header files related to Clock Drivers for Actions Semi Socs.
>>>>> For C header files Documentation/process/license-rules.rst
>>>>> mandates C-like comments (opposed to C source files where
>>>>> C++ style should be used)
>>>> [...]
>>>>>  drivers/clk/actions/owl-common.h       | 2 +-
>>>>>  drivers/clk/actions/owl-composite.h    | 2 +-
>>>>>  drivers/clk/actions/owl-divider.h      | 2 +-
>>>>>  drivers/clk/actions/owl-factor.h       | 2 +-
>>>>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
>>>>>  drivers/clk/actions/owl-gate.h         | 2 +-
>>>>>  drivers/clk/actions/owl-mux.h          | 2 +-
>>>>>  drivers/clk/actions/owl-pll.h          | 2 +-
>>>>>  drivers/clk/actions/owl-reset.h        | 2 +-
>>>>>  9 files changed, 9 insertions(+), 9 deletions(-)
>>>>
>>>> Where's the practical benefit of this patch? These are all private
>>>> headers used from C files, so they can handle C++ comments just fine,
>>>> otherwise we would've seen build failures.
>>>
>>> Please read Documentation/process/license-rules.rst, the section
>>> entitled "Style", for what the documented formats are for SPDX lines,
>>> depending on the file type.
>>
>> That does in no way answer my question! You conveniently dropped my
>> paragraph indicating that I understand why we would do that for public
>> headers in include/, but none of these private headers here are included
>> in .lds files. So there really seems to be no benefit of switching from
>> one style to another for in-tree code.
> 
> It should answer the question, it was "decreed" that all header files
> use /* */, and all C files use // for their SPDX lines, so we documented
> it that way.
> 
> Yes, maybe it doesn't make "sense" in that this really is only needed
> for headers that get included into asm files, which is why we had to do
> it this way, but it's better to be consistant than to have random
> breakages at times.
> 
> It's not an issue of public headers at all, sorry.
> 
> Consistency is good, as we can have automatic tools check these types of
> things, which is the only way to reliably handle the format of something
> that needs to be in every file in a project with 63,100+ different
> files.

Okay, if it's about consistency then there will be more cases to fix.

What about this one:

My interpretation of the documentation has been that I should end the
comment after the identifiers:

/* SPDX-... */
/* ...
 */

Some people deviate by doing

/* SPDX-...
 * foo
 */

So the documentation may need to be extended to clarify that for full
consistency, as well as clarify the previous scenario:
  "If a specific tool cannot handle the standard comment style, then the
   appropriate comment mechanism which the tool accepts shall be used."
To me that reads very different from what you just said above.

Thanks,
Andreas

-- 
SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
HRB 21284 (AG Nürnberg)

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-02 10:45           ` Andreas Färber
  0 siblings, 0 replies; 15+ messages in thread
From: Andreas Färber @ 2019-05-02 10:45 UTC (permalink / raw)
  To: Greg Kroah-Hartman
  Cc: Nishad Kamdar, Stephen Boyd, Michael Turquette,
	Manivannan Sadhasivam, linux-actions, linux-kernel,
	Uwe Kleine-König, Joe Perches, linux-clk, linux-arm-kernel

Am 02.05.19 um 12:38 schrieb Greg Kroah-Hartman:
> On Thu, May 02, 2019 at 12:25:36PM +0200, Andreas Färber wrote:
>> Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
>>> On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
>>>> + linux-actions
>>>>
>>>> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
>>>>> This patch corrects the SPDX License Identifier style
>>>>> in header files related to Clock Drivers for Actions Semi Socs.
>>>>> For C header files Documentation/process/license-rules.rst
>>>>> mandates C-like comments (opposed to C source files where
>>>>> C++ style should be used)
>>>> [...]
>>>>>  drivers/clk/actions/owl-common.h       | 2 +-
>>>>>  drivers/clk/actions/owl-composite.h    | 2 +-
>>>>>  drivers/clk/actions/owl-divider.h      | 2 +-
>>>>>  drivers/clk/actions/owl-factor.h       | 2 +-
>>>>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
>>>>>  drivers/clk/actions/owl-gate.h         | 2 +-
>>>>>  drivers/clk/actions/owl-mux.h          | 2 +-
>>>>>  drivers/clk/actions/owl-pll.h          | 2 +-
>>>>>  drivers/clk/actions/owl-reset.h        | 2 +-
>>>>>  9 files changed, 9 insertions(+), 9 deletions(-)
>>>>
>>>> Where's the practical benefit of this patch? These are all private
>>>> headers used from C files, so they can handle C++ comments just fine,
>>>> otherwise we would've seen build failures.
>>>
>>> Please read Documentation/process/license-rules.rst, the section
>>> entitled "Style", for what the documented formats are for SPDX lines,
>>> depending on the file type.
>>
>> That does in no way answer my question! You conveniently dropped my
>> paragraph indicating that I understand why we would do that for public
>> headers in include/, but none of these private headers here are included
>> in .lds files. So there really seems to be no benefit of switching from
>> one style to another for in-tree code.
> 
> It should answer the question, it was "decreed" that all header files
> use /* */, and all C files use // for their SPDX lines, so we documented
> it that way.
> 
> Yes, maybe it doesn't make "sense" in that this really is only needed
> for headers that get included into asm files, which is why we had to do
> it this way, but it's better to be consistant than to have random
> breakages at times.
> 
> It's not an issue of public headers at all, sorry.
> 
> Consistency is good, as we can have automatic tools check these types of
> things, which is the only way to reliably handle the format of something
> that needs to be in every file in a project with 63,100+ different
> files.

Okay, if it's about consistency then there will be more cases to fix.

What about this one:

My interpretation of the documentation has been that I should end the
comment after the identifiers:

/* SPDX-... */
/* ...
 */

Some people deviate by doing

/* SPDX-...
 * foo
 */

So the documentation may need to be extended to clarify that for full
consistency, as well as clarify the previous scenario:
  "If a specific tool cannot handle the standard comment style, then the
   appropriate comment mechanism which the tool accepts shall be used."
To me that reads very different from what you just said above.

Thanks,
Andreas

-- 
SUSE Linux GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
HRB 21284 (AG Nürnberg)

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
  2019-05-02 10:45           ` Andreas Färber
@ 2019-05-02 11:28             ` Greg Kroah-Hartman
  -1 siblings, 0 replies; 15+ messages in thread
From: Greg Kroah-Hartman @ 2019-05-02 11:28 UTC (permalink / raw)
  To: Andreas Färber
  Cc: Nishad Kamdar, Manivannan Sadhasivam, Michael Turquette,
	Stephen Boyd, Joe Perches, Uwe Kleine-König,
	linux-arm-kernel, linux-clk, linux-kernel, linux-actions

On Thu, May 02, 2019 at 12:45:05PM +0200, Andreas Färber wrote:
> Am 02.05.19 um 12:38 schrieb Greg Kroah-Hartman:
> > On Thu, May 02, 2019 at 12:25:36PM +0200, Andreas Färber wrote:
> >> Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
> >>> On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
> >>>> + linux-actions
> >>>>
> >>>> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> >>>>> This patch corrects the SPDX License Identifier style
> >>>>> in header files related to Clock Drivers for Actions Semi Socs.
> >>>>> For C header files Documentation/process/license-rules.rst
> >>>>> mandates C-like comments (opposed to C source files where
> >>>>> C++ style should be used)
> >>>> [...]
> >>>>>  drivers/clk/actions/owl-common.h       | 2 +-
> >>>>>  drivers/clk/actions/owl-composite.h    | 2 +-
> >>>>>  drivers/clk/actions/owl-divider.h      | 2 +-
> >>>>>  drivers/clk/actions/owl-factor.h       | 2 +-
> >>>>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
> >>>>>  drivers/clk/actions/owl-gate.h         | 2 +-
> >>>>>  drivers/clk/actions/owl-mux.h          | 2 +-
> >>>>>  drivers/clk/actions/owl-pll.h          | 2 +-
> >>>>>  drivers/clk/actions/owl-reset.h        | 2 +-
> >>>>>  9 files changed, 9 insertions(+), 9 deletions(-)
> >>>>
> >>>> Where's the practical benefit of this patch? These are all private
> >>>> headers used from C files, so they can handle C++ comments just fine,
> >>>> otherwise we would've seen build failures.
> >>>
> >>> Please read Documentation/process/license-rules.rst, the section
> >>> entitled "Style", for what the documented formats are for SPDX lines,
> >>> depending on the file type.
> >>
> >> That does in no way answer my question! You conveniently dropped my
> >> paragraph indicating that I understand why we would do that for public
> >> headers in include/, but none of these private headers here are included
> >> in .lds files. So there really seems to be no benefit of switching from
> >> one style to another for in-tree code.
> > 
> > It should answer the question, it was "decreed" that all header files
> > use /* */, and all C files use // for their SPDX lines, so we documented
> > it that way.
> > 
> > Yes, maybe it doesn't make "sense" in that this really is only needed
> > for headers that get included into asm files, which is why we had to do
> > it this way, but it's better to be consistant than to have random
> > breakages at times.
> > 
> > It's not an issue of public headers at all, sorry.
> > 
> > Consistency is good, as we can have automatic tools check these types of
> > things, which is the only way to reliably handle the format of something
> > that needs to be in every file in a project with 63,100+ different
> > files.
> 
> Okay, if it's about consistency then there will be more cases to fix.

Agreed, hopefully checkpatch is up to date enough to catch these.

> What about this one:
> 
> My interpretation of the documentation has been that I should end the
> comment after the identifiers:
> 
> /* SPDX-... */
> /* ...
>  */

Correct.

> Some people deviate by doing
> 
> /* SPDX-...
>  * foo
>  */

Not correct.

> So the documentation may need to be extended to clarify that for full
> consistency, as well as clarify the previous scenario:
>   "If a specific tool cannot handle the standard comment style, then the
>    appropriate comment mechanism which the tool accepts shall be used."
> To me that reads very different from what you just said above.

Documentation can always be updated, a patch to make it clearer is
always appreciated.  But look at what we have today in the document, I
think it should be pretty obvious that:
	/* SPDX... */
is the thing to use for C header files.

If you disagree, that's fine, please send a patch to make it clearer and
we can all review it.

thanks,

greg k-h

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: [PATCH] clk: actions: Use the correct style for SPDX License Identifier
@ 2019-05-02 11:28             ` Greg Kroah-Hartman
  0 siblings, 0 replies; 15+ messages in thread
From: Greg Kroah-Hartman @ 2019-05-02 11:28 UTC (permalink / raw)
  To: Andreas Färber
  Cc: Nishad Kamdar, Stephen Boyd, Michael Turquette,
	Manivannan Sadhasivam, linux-actions, linux-kernel,
	Uwe Kleine-König, Joe Perches, linux-clk, linux-arm-kernel

On Thu, May 02, 2019 at 12:45:05PM +0200, Andreas Färber wrote:
> Am 02.05.19 um 12:38 schrieb Greg Kroah-Hartman:
> > On Thu, May 02, 2019 at 12:25:36PM +0200, Andreas Färber wrote:
> >> Am 02.05.19 um 09:07 schrieb Greg Kroah-Hartman:
> >>> On Wed, May 01, 2019 at 10:20:44PM +0200, Andreas Färber wrote:
> >>>> + linux-actions
> >>>>
> >>>> Am 01.05.19 um 09:07 schrieb Nishad Kamdar:
> >>>>> This patch corrects the SPDX License Identifier style
> >>>>> in header files related to Clock Drivers for Actions Semi Socs.
> >>>>> For C header files Documentation/process/license-rules.rst
> >>>>> mandates C-like comments (opposed to C source files where
> >>>>> C++ style should be used)
> >>>> [...]
> >>>>>  drivers/clk/actions/owl-common.h       | 2 +-
> >>>>>  drivers/clk/actions/owl-composite.h    | 2 +-
> >>>>>  drivers/clk/actions/owl-divider.h      | 2 +-
> >>>>>  drivers/clk/actions/owl-factor.h       | 2 +-
> >>>>>  drivers/clk/actions/owl-fixed-factor.h | 2 +-
> >>>>>  drivers/clk/actions/owl-gate.h         | 2 +-
> >>>>>  drivers/clk/actions/owl-mux.h          | 2 +-
> >>>>>  drivers/clk/actions/owl-pll.h          | 2 +-
> >>>>>  drivers/clk/actions/owl-reset.h        | 2 +-
> >>>>>  9 files changed, 9 insertions(+), 9 deletions(-)
> >>>>
> >>>> Where's the practical benefit of this patch? These are all private
> >>>> headers used from C files, so they can handle C++ comments just fine,
> >>>> otherwise we would've seen build failures.
> >>>
> >>> Please read Documentation/process/license-rules.rst, the section
> >>> entitled "Style", for what the documented formats are for SPDX lines,
> >>> depending on the file type.
> >>
> >> That does in no way answer my question! You conveniently dropped my
> >> paragraph indicating that I understand why we would do that for public
> >> headers in include/, but none of these private headers here are included
> >> in .lds files. So there really seems to be no benefit of switching from
> >> one style to another for in-tree code.
> > 
> > It should answer the question, it was "decreed" that all header files
> > use /* */, and all C files use // for their SPDX lines, so we documented
> > it that way.
> > 
> > Yes, maybe it doesn't make "sense" in that this really is only needed
> > for headers that get included into asm files, which is why we had to do
> > it this way, but it's better to be consistant than to have random
> > breakages at times.
> > 
> > It's not an issue of public headers at all, sorry.
> > 
> > Consistency is good, as we can have automatic tools check these types of
> > things, which is the only way to reliably handle the format of something
> > that needs to be in every file in a project with 63,100+ different
> > files.
> 
> Okay, if it's about consistency then there will be more cases to fix.

Agreed, hopefully checkpatch is up to date enough to catch these.

> What about this one:
> 
> My interpretation of the documentation has been that I should end the
> comment after the identifiers:
> 
> /* SPDX-... */
> /* ...
>  */

Correct.

> Some people deviate by doing
> 
> /* SPDX-...
>  * foo
>  */

Not correct.

> So the documentation may need to be extended to clarify that for full
> consistency, as well as clarify the previous scenario:
>   "If a specific tool cannot handle the standard comment style, then the
>    appropriate comment mechanism which the tool accepts shall be used."
> To me that reads very different from what you just said above.

Documentation can always be updated, a patch to make it clearer is
always appreciated.  But look at what we have today in the document, I
think it should be pretty obvious that:
	/* SPDX... */
is the thing to use for C header files.

If you disagree, that's fine, please send a patch to make it clearer and
we can all review it.

thanks,

greg k-h

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

^ permalink raw reply	[flat|nested] 15+ messages in thread

end of thread, other threads:[~2019-05-02 11:29 UTC | newest]

Thread overview: 15+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-05-01  7:07 [PATCH] clk: actions: Use the correct style for SPDX License Identifier Nishad Kamdar
2019-05-01  7:07 ` Nishad Kamdar
2019-05-01 20:02 ` Stephen Boyd
2019-05-01 20:20 ` Andreas Färber
2019-05-01 20:20   ` Andreas Färber
2019-05-02  7:07   ` Greg Kroah-Hartman
2019-05-02  7:07     ` Greg Kroah-Hartman
2019-05-02 10:25     ` Andreas Färber
2019-05-02 10:25       ` Andreas Färber
2019-05-02 10:38       ` Greg Kroah-Hartman
2019-05-02 10:38         ` Greg Kroah-Hartman
2019-05-02 10:45         ` Andreas Färber
2019-05-02 10:45           ` Andreas Färber
2019-05-02 11:28           ` Greg Kroah-Hartman
2019-05-02 11:28             ` Greg Kroah-Hartman

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.