lkml.org 
[lkml]   [2023]   [Jul]   [19]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH v2 2/3] Documentation/process: maintainer-soc: add clean platforms profile
    Date
    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 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 | 23 +++++++++++++++++++
    MAINTAINERS | 2 +-
    3 files changed, 25 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..c460923f39be
    --- /dev/null
    +++ b/Documentation/process/maintainer-soc-clean-dts.rst
    @@ -0,0 +1,23 @@
    +.. 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. However platforms referencing
    +this document impose additional requirements listed below.
    +
    +Strict DTS DT Schema Compliance
    +-------------------------------
    +
    +No changes to the SoC platform Devicetree sources (DTS files) should introduce
    +new ``make dtbs_check W=1`` warnings. The platform maintainers have automation
    +in place which should point out any new warnings.
    +
    +If a commit introducing new warning 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 ba5e7344f30e..a70c32790427 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
    \
     
     \ /
      Last update: 2023-07-19 16:34    [W:4.278 / U:0.020 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site