Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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 <krzysztof.kozlowski@linaro.org>
Reviewed-by: Conor Dooley <conor.dooley@microchip.com>
Link: https://lore.kernel.org/r/20230723131924.78190-2-krzysztof.kozlowski@linaro.org
Signed-off-by: Arnd Bergmann <arnd@arndb.de>

authored by

Krzysztof Kozlowski and committed by
Arnd Bergmann
f1b518b4 a34d8a4b

+27 -1
+1
Documentation/process/maintainer-handbooks.rst
··· 17 17 18 18 maintainer-netdev 19 19 maintainer-soc 20 + maintainer-soc-clean-dts 20 21 maintainer-tip 21 22 maintainer-kvm-x86
+25
Documentation/process/maintainer-soc-clean-dts.rst
··· 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.
+1 -1
MAINTAINERS
··· 1561 1561 P: Documentation/process/maintainer-soc.rst 1562 1562 C: irc://irc.libera.chat/armlinux 1563 1563 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 1565 1565 F: arch/arm/boot/dts/Makefile 1566 1566 F: arch/arm64/boot/dts/Makefile 1567 1567