Skip to content

Commit f1b518b

Browse files
krzkarndb
authored andcommitted
Documentation/process: maintainer-soc: add clean platforms profile
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 <[email protected]> Reviewed-by: Conor Dooley <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Arnd Bergmann <[email protected]>
1 parent a34d8a4 commit f1b518b

File tree

3 files changed

+27
-1
lines changed

3 files changed

+27
-1
lines changed

Documentation/process/maintainer-handbooks.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,5 +17,6 @@ Contents:
1717

1818
maintainer-netdev
1919
maintainer-soc
20+
maintainer-soc-clean-dts
2021
maintainer-tip
2122
maintainer-kvm-x86
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
.. SPDX-License-Identifier: GPL-2.0
2+
3+
==============================================
4+
SoC Platforms with DTS Compliance Requirements
5+
==============================================
6+
7+
Overview
8+
--------
9+
10+
SoC platforms or subarchitectures should follow all the rules from
11+
Documentation/process/maintainer-soc.rst. This document referenced in
12+
MAINTAINERS impose additional requirements listed below.
13+
14+
Strict DTS DT Schema and dtc Compliance
15+
---------------------------------------
16+
17+
No changes to the SoC platform Devicetree sources (DTS files) should introduce
18+
new ``make dtbs_check W=1`` warnings. Warnings in a new board DTS, which are
19+
results of issues in an included DTSI file, are considered existing, not new
20+
warnings. The platform maintainers have automation in place which should point
21+
out any new warnings.
22+
23+
If a commit introducing new warnings gets accepted somehow, the resulting
24+
issues shall be fixed in reasonable time (e.g. within one release) or the
25+
commit reverted.

MAINTAINERS

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1561,7 +1561,7 @@ S: Maintained
15611561
P: Documentation/process/maintainer-soc.rst
15621562
C: irc://irc.libera.chat/armlinux
15631563
T: git git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc.git
1564-
F: Documentation/process/maintainer-soc.rst
1564+
F: Documentation/process/maintainer-soc*.rst
15651565
F: arch/arm/boot/dts/Makefile
15661566
F: arch/arm64/boot/dts/Makefile
15671567

0 commit comments

Comments
 (0)