* [PATCH] Documentation: bindings: Warn about yamllint and dt-schema before submitting patches
@ 2021-12-16 16:47 Alexandre Ghiti
2021-12-22 17:17 ` Rob Herring
0 siblings, 1 reply; 2+ messages in thread
From: Alexandre Ghiti @ 2021-12-16 16:47 UTC (permalink / raw)
To: Rob Herring, devicetree, linux-kernel; +Cc: Alexandre Ghiti
Make sure people know that yamllint must be installed and dt-schema up
to date before they submit device tree bindings patches.
Signed-off-by: Alexandre Ghiti <alexandre.ghiti@canonical.com>
---
Documentation/devicetree/bindings/submitting-patches.rst | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/Documentation/devicetree/bindings/submitting-patches.rst b/Documentation/devicetree/bindings/submitting-patches.rst
index 36a17b250ccc..3553e90bef5a 100644
--- a/Documentation/devicetree/bindings/submitting-patches.rst
+++ b/Documentation/devicetree/bindings/submitting-patches.rst
@@ -25,6 +25,10 @@ I. For patch submitters
make dt_binding_check
+ Make sure yamllint is installed and dt-schema is up to date::
+
+ pip3 install dtschema --upgrade
+
See Documentation/devicetree/bindings/writing-schema.rst for more details
about schema and tools setup.
--
2.32.0
^ permalink raw reply related [flat|nested] 2+ messages in thread* Re: [PATCH] Documentation: bindings: Warn about yamllint and dt-schema before submitting patches
2021-12-16 16:47 [PATCH] Documentation: bindings: Warn about yamllint and dt-schema before submitting patches Alexandre Ghiti
@ 2021-12-22 17:17 ` Rob Herring
0 siblings, 0 replies; 2+ messages in thread
From: Rob Herring @ 2021-12-22 17:17 UTC (permalink / raw)
To: Alexandre Ghiti; +Cc: devicetree, linux-kernel
On Thu, Dec 16, 2021 at 05:47:27PM +0100, Alexandre Ghiti wrote:
> Make sure people know that yamllint must be installed and dt-schema up
> to date before they submit device tree bindings patches.
>
> Signed-off-by: Alexandre Ghiti <alexandre.ghiti@canonical.com>
> ---
> Documentation/devicetree/bindings/submitting-patches.rst | 4 ++++
> 1 file changed, 4 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/submitting-patches.rst b/Documentation/devicetree/bindings/submitting-patches.rst
> index 36a17b250ccc..3553e90bef5a 100644
> --- a/Documentation/devicetree/bindings/submitting-patches.rst
> +++ b/Documentation/devicetree/bindings/submitting-patches.rst
> @@ -25,6 +25,10 @@ I. For patch submitters
>
> make dt_binding_check
>
This will already tell you if dt-schema is out of date.
yamllint is optional for the build system, but we could make it
required or warn when not present. I think people do get surprised by
yamllint warnings reported.
> + Make sure yamllint is installed and dt-schema is up to date::
> +
> + pip3 install dtschema --upgrade
> +
> See Documentation/devicetree/bindings/writing-schema.rst for more details
This already has details on running pip3, so now we have it in 2 places.
And they don't match because writing-schema.rst says how to install from
git rather than pypi. Not sure what happens if you install from git and
then run the above...
> about schema and tools setup.
>
> --
> 2.32.0
>
>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2021-12-22 17:17 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-12-16 16:47 [PATCH] Documentation: bindings: Warn about yamllint and dt-schema before submitting patches Alexandre Ghiti
2021-12-22 17:17 ` Rob Herring
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).