* [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile
@ 2023-07-23 13:19 Krzysztof Kozlowski
2023-07-23 13:19 ` [PATCH v3 2/3] Documentation/process: maintainer-soc: add clean platforms profile Krzysztof Kozlowski
` (2 more replies)
0 siblings, 3 replies; 5+ messages in thread
From: Krzysztof Kozlowski @ 2023-07-23 13:19 UTC (permalink / raw)
To: Rob Herring, Krzysztof Kozlowski, Conor Dooley, Alim Akhtar,
Andy Gross, Bjorn Andersson, Konrad Dybcio, devicetree,
linux-arm-kernel, linux-samsung-soc, linux-kernel, linux-arm-msm,
Jonathan Corbet, Arnd Bergmann, Olof Johansson, soc, workflows,
linux-doc, arm
Cc: Krzysztof Kozlowski, Randy Dunlap
Mention the SoC maintainer profile in P: entry.
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
---
Changes in v3:
1. None
Changes in v2:
1. Add Rb tag.
---
MAINTAINERS | 1 +
1 file changed, 1 insertion(+)
diff --git a/MAINTAINERS b/MAINTAINERS
index 3dfa40abc885..7624eb231b65 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1570,6 +1570,7 @@ M: Olof Johansson <olof@lixom.net>
M: soc@kernel.org
L: linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
S: Maintained
+P: Documentation/process/maintainer-soc.rst
C: irc://irc.libera.chat/armlinux
T: git git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc.git
F: Documentation/process/maintainer-soc.rst
--
2.34.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [PATCH v3 2/3] Documentation/process: maintainer-soc: add clean platforms profile
2023-07-23 13:19 [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile Krzysztof Kozlowski
@ 2023-07-23 13:19 ` Krzysztof Kozlowski
2023-07-23 13:19 ` [PATCH v3 3/3] MAINTAINER: samsung: document dtbs_check requirement for Samsung Krzysztof Kozlowski
2023-07-31 16:23 ` [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile Jonathan Corbet
2 siblings, 0 replies; 5+ messages in thread
From: Krzysztof Kozlowski @ 2023-07-23 13:19 UTC (permalink / raw)
To: Rob Herring, Krzysztof Kozlowski, Conor Dooley, Alim Akhtar,
Andy Gross, Bjorn Andersson, Konrad Dybcio, devicetree,
linux-arm-kernel, linux-samsung-soc, linux-kernel, linux-arm-msm,
Jonathan Corbet, Arnd Bergmann, Olof Johansson, soc, workflows,
linux-doc, arm
Cc: Krzysztof Kozlowski, Conor Dooley
Some SoC platforms require that commits must not bring any new
dtbs_check warnings. Maintainers of such platforms usually have some
automation set, so any new warning will be spotted sooner or later.
Worst case: they run the tests themselves. Document requirements for
such platforms, so contributors can expect their patches being dropped
or ignored, if they bring new warnings for existing boards.
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Conor Dooley <conor.dooley@microchip.com>
---
Changes in v3:
1. Rephrase according to Rob's comments (this document when referenced
in maintainers, "... and dtc Compliance", existing warnings are not
new warnings).
Changes in v2:
1. Add Rb tag.
2. Implement Conor's feedback: change doc title, follow->should follow,
minor style changes.
---
.../process/maintainer-handbooks.rst | 1 +
.../process/maintainer-soc-clean-dts.rst | 25 +++++++++++++++++++
MAINTAINERS | 2 +-
3 files changed, 27 insertions(+), 1 deletion(-)
create mode 100644 Documentation/process/maintainer-soc-clean-dts.rst
diff --git a/Documentation/process/maintainer-handbooks.rst b/Documentation/process/maintainer-handbooks.rst
index 9992bfd7eaa3..976391cec528 100644
--- a/Documentation/process/maintainer-handbooks.rst
+++ b/Documentation/process/maintainer-handbooks.rst
@@ -17,5 +17,6 @@ Contents:
maintainer-netdev
maintainer-soc
+ maintainer-soc-clean-dts
maintainer-tip
maintainer-kvm-x86
diff --git a/Documentation/process/maintainer-soc-clean-dts.rst b/Documentation/process/maintainer-soc-clean-dts.rst
new file mode 100644
index 000000000000..1b32430d0cfc
--- /dev/null
+++ b/Documentation/process/maintainer-soc-clean-dts.rst
@@ -0,0 +1,25 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+==============================================
+SoC Platforms with DTS Compliance Requirements
+==============================================
+
+Overview
+--------
+
+SoC platforms or subarchitectures should follow all the rules from
+Documentation/process/maintainer-soc.rst. This document referenced in
+MAINTAINERS impose additional requirements listed below.
+
+Strict DTS DT Schema and dtc Compliance
+---------------------------------------
+
+No changes to the SoC platform Devicetree sources (DTS files) should introduce
+new ``make dtbs_check W=1`` warnings. Warnings in a new board DTS, which are
+results of issues in an included DTSI file, are considered existing, not new
+warnings. The platform maintainers have automation in place which should point
+out any new warnings.
+
+If a commit introducing new warnings gets accepted somehow, the resulting
+issues shall be fixed in reasonable time (e.g. within one release) or the
+commit reverted.
diff --git a/MAINTAINERS b/MAINTAINERS
index 7624eb231b65..9fe3870300f2 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1573,7 +1573,7 @@ S: Maintained
P: Documentation/process/maintainer-soc.rst
C: irc://irc.libera.chat/armlinux
T: git git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc.git
-F: Documentation/process/maintainer-soc.rst
+F: Documentation/process/maintainer-soc*.rst
F: arch/arm/boot/dts/Makefile
F: arch/arm64/boot/dts/Makefile
--
2.34.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [PATCH v3 3/3] MAINTAINER: samsung: document dtbs_check requirement for Samsung
2023-07-23 13:19 [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile Krzysztof Kozlowski
2023-07-23 13:19 ` [PATCH v3 2/3] Documentation/process: maintainer-soc: add clean platforms profile Krzysztof Kozlowski
@ 2023-07-23 13:19 ` Krzysztof Kozlowski
2023-07-24 14:33 ` Alim Akhtar
2023-07-31 16:23 ` [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile Jonathan Corbet
2 siblings, 1 reply; 5+ messages in thread
From: Krzysztof Kozlowski @ 2023-07-23 13:19 UTC (permalink / raw)
To: Rob Herring, Krzysztof Kozlowski, Conor Dooley, Alim Akhtar,
Andy Gross, Bjorn Andersson, Konrad Dybcio, devicetree,
linux-arm-kernel, linux-samsung-soc, linux-kernel, linux-arm-msm,
Jonathan Corbet, Arnd Bergmann, Olof Johansson, soc, workflows,
linux-doc, arm
Cc: Krzysztof Kozlowski
Samsung ARM/ARM64 SoCs (including legacy S3C64xx and S5PV210) are also
expected not to bring any new dtbs_check warnings. In fact this have
been already enforced and tested since few release.
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
Changes in v3:
1. None
Changes in v2:
1. None
---
MAINTAINERS | 1 +
1 file changed, 1 insertion(+)
diff --git a/MAINTAINERS b/MAINTAINERS
index 9fe3870300f2..4b299e39111d 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -2646,6 +2646,7 @@ R: Alim Akhtar <alim.akhtar@samsung.com>
L: linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
L: linux-samsung-soc@vger.kernel.org
S: Maintained
+P: Documentation/process/maintainer-soc-clean-dts.rst
Q: https://patchwork.kernel.org/project/linux-samsung-soc/list/
B: mailto:linux-samsung-soc@vger.kernel.org
C: irc://irc.libera.chat/linux-exynos
--
2.34.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* RE: [PATCH v3 3/3] MAINTAINER: samsung: document dtbs_check requirement for Samsung
2023-07-23 13:19 ` [PATCH v3 3/3] MAINTAINER: samsung: document dtbs_check requirement for Samsung Krzysztof Kozlowski
@ 2023-07-24 14:33 ` Alim Akhtar
0 siblings, 0 replies; 5+ messages in thread
From: Alim Akhtar @ 2023-07-24 14:33 UTC (permalink / raw)
To: 'Krzysztof Kozlowski', 'Rob Herring',
'Krzysztof Kozlowski', 'Conor Dooley',
'Andy Gross', 'Bjorn Andersson',
'Konrad Dybcio',
devicetree, linux-arm-kernel, linux-samsung-soc, linux-kernel,
linux-arm-msm, 'Jonathan Corbet', 'Arnd Bergmann',
'Olof Johansson',
soc, workflows, linux-doc, arm
> -----Original Message-----
> From: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> Sent: Sunday, July 23, 2023 6:49 PM
> To: Rob Herring <robh+dt@kernel.org>; Krzysztof Kozlowski
> <krzysztof.kozlowski+dt@linaro.org>; Conor Dooley <conor+dt@kernel.org>;
> Alim Akhtar <alim.akhtar@samsung.com>; Andy Gross <agross@kernel.org>;
> Bjorn Andersson <andersson@kernel.org>; Konrad Dybcio
> <konrad.dybcio@linaro.org>; devicetree@vger.kernel.org; linux-arm-
> kernel@lists.infradead.org; linux-samsung-soc@vger.kernel.org; linux-
> kernel@vger.kernel.org; linux-arm-msm@vger.kernel.org; Jonathan Corbet
> <corbet@lwn.net>; Arnd Bergmann <arnd@arndb.de>; Olof Johansson
> <olof@lixom.net>; soc@kernel.org; workflows@vger.kernel.org; linux-
> doc@vger.kernel.org; arm@kernel.org
> Cc: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> Subject: [PATCH v3 3/3] MAINTAINER: samsung: document dtbs_check
> requirement for Samsung
>
> Samsung ARM/ARM64 SoCs (including legacy S3C64xx and S5PV210) are also
> expected not to bring any new dtbs_check warnings. In fact this have been
> already enforced and tested since few release.
>
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>
Reviewed-by: Alim Akhtar <alim.akhtar@samsung.com>
> ---
>
> Changes in v3:
> 1. None
>
> Changes in v2:
> 1. None
> ---
> MAINTAINERS | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 9fe3870300f2..4b299e39111d 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -2646,6 +2646,7 @@ R: Alim Akhtar <alim.akhtar@samsung.com>
> L: linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
> L: linux-samsung-soc@vger.kernel.org
> S: Maintained
> +P: Documentation/process/maintainer-soc-clean-dts.rst
> Q: https://patchwork.kernel.org/project/linux-samsung-soc/list/
> B: mailto:linux-samsung-soc@vger.kernel.org
> C: irc://irc.libera.chat/linux-exynos
> --
> 2.34.1
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile
2023-07-23 13:19 [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile Krzysztof Kozlowski
2023-07-23 13:19 ` [PATCH v3 2/3] Documentation/process: maintainer-soc: add clean platforms profile Krzysztof Kozlowski
2023-07-23 13:19 ` [PATCH v3 3/3] MAINTAINER: samsung: document dtbs_check requirement for Samsung Krzysztof Kozlowski
@ 2023-07-31 16:23 ` Jonathan Corbet
2 siblings, 0 replies; 5+ messages in thread
From: Jonathan Corbet @ 2023-07-31 16:23 UTC (permalink / raw)
To: Krzysztof Kozlowski, Rob Herring, Krzysztof Kozlowski,
Conor Dooley, Alim Akhtar, Andy Gross, Bjorn Andersson,
Konrad Dybcio, devicetree, linux-arm-kernel, linux-samsung-soc,
linux-kernel, linux-arm-msm, Arnd Bergmann, Olof Johansson, soc,
workflows, linux-doc, arm
Cc: Krzysztof Kozlowski, Randy Dunlap
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> writes:
> Mention the SoC maintainer profile in P: entry.
>
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
I've applied this series, thanks.
jon
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2023-07-31 16:23 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-07-23 13:19 [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile Krzysztof Kozlowski
2023-07-23 13:19 ` [PATCH v3 2/3] Documentation/process: maintainer-soc: add clean platforms profile Krzysztof Kozlowski
2023-07-23 13:19 ` [PATCH v3 3/3] MAINTAINER: samsung: document dtbs_check requirement for Samsung Krzysztof Kozlowski
2023-07-24 14:33 ` Alim Akhtar
2023-07-31 16:23 ` [PATCH v3 1/3] MAINTAINERS: soc: reference maintainer profile Jonathan Corbet
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).