* [PATCH] dt-bindings: pip command elaboration
@ 2020-08-12 7:06 Linus Walleij
2020-08-12 16:24 ` Rob Herring
0 siblings, 1 reply; 2+ messages in thread
From: Linus Walleij @ 2020-08-12 7:06 UTC (permalink / raw)
To: Rob Herring, Mark Rutland; +Cc: devicetree, Linus Walleij
pip is now for most practical set-ups implied to be pip3, so
just use "pip" rather than "pip3" in the instructions.
Pass --user explicitly in the example so it is clear that this
gets installed in the user home directory.
Add an additional instruction on how to upgrade the project,
not everyone is aware of how pip works.
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
---
Documentation/devicetree/writing-schema.rst | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/Documentation/devicetree/writing-schema.rst b/Documentation/devicetree/writing-schema.rst
index 8c74a99f95e2..a9cebfca8d31 100644
--- a/Documentation/devicetree/writing-schema.rst
+++ b/Documentation/devicetree/writing-schema.rst
@@ -115,11 +115,16 @@ The DT schema project must be installed in order to validate the DT schema
binding documents and validate DTS files using the DT schema. The DT schema
project can be installed with pip::
- pip3 install git+https://github.com/devicetree-org/dt-schema.git@master
+ pip install --user git+https://github.com/devicetree-org/dt-schema.git@master
Several executables (dt-doc-validate, dt-mk-schema, dt-validate) will be
installed. Ensure they are in your PATH (~/.local/bin by default).
+We sometimes update th DT schema project, and then you can simply add the
+"--upgrade" option to the above command to get to the latest version:
+
+ pip install --user --upgrade git+https://github.com/devicetree-org/dt-schema.git@master
+
dtc must also be built with YAML output support enabled. This requires that
libyaml and its headers be installed on the host system. For some distributions
that involves installing the development package, such as:
--
2.26.2
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: [PATCH] dt-bindings: pip command elaboration
2020-08-12 7:06 [PATCH] dt-bindings: pip command elaboration Linus Walleij
@ 2020-08-12 16:24 ` Rob Herring
0 siblings, 0 replies; 2+ messages in thread
From: Rob Herring @ 2020-08-12 16:24 UTC (permalink / raw)
To: Linus Walleij; +Cc: Mark Rutland, devicetree
On Wed, Aug 12, 2020 at 1:06 AM Linus Walleij <linus.walleij@linaro.org> wrote:
>
> pip is now for most practical set-ups implied to be pip3, so
> just use "pip" rather than "pip3" in the instructions.
Are you sure about that? A fresh ubuntu 20.04 install for me defaulted
to python2 for 'python' and 'pip'. From what I've read, that should
always be the case. Anything expressly needing python3 should be
explicit. But then ubuntu has python-is-python2 and python-is-python3
packages to set the default, so I'm confused... (I was trying to
figure out what to do with spdxcheck.py which broke on 20.04 because
the new version of the 'git' python module is python3 only and
spdxcheck.py was using python2.)
In any case, pip3 always works and pip may or may not work. So I think
the answer here is obvious.
> Pass --user explicitly in the example so it is clear that this
> gets installed in the user home directory.
>
> Add an additional instruction on how to upgrade the project,
> not everyone is aware of how pip works.
BTW, releases are now on PyPi, so you can do just 'pip3 install
dtschema'. I've been meaning to update this doc with that.
>
> Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
> ---
> Documentation/devicetree/writing-schema.rst | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/devicetree/writing-schema.rst b/Documentation/devicetree/writing-schema.rst
> index 8c74a99f95e2..a9cebfca8d31 100644
> --- a/Documentation/devicetree/writing-schema.rst
> +++ b/Documentation/devicetree/writing-schema.rst
> @@ -115,11 +115,16 @@ The DT schema project must be installed in order to validate the DT schema
> binding documents and validate DTS files using the DT schema. The DT schema
> project can be installed with pip::
>
> - pip3 install git+https://github.com/devicetree-org/dt-schema.git@master
> + pip install --user git+https://github.com/devicetree-org/dt-schema.git@master
>
> Several executables (dt-doc-validate, dt-mk-schema, dt-validate) will be
> installed. Ensure they are in your PATH (~/.local/bin by default).
>
> +We sometimes update th DT schema project, and then you can simply add the
> +"--upgrade" option to the above command to get to the latest version:
> +
> + pip install --user --upgrade git+https://github.com/devicetree-org/dt-schema.git@master
> +
> dtc must also be built with YAML output support enabled. This requires that
> libyaml and its headers be installed on the host system. For some distributions
> that involves installing the development package, such as:
> --
> 2.26.2
>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2020-08-12 16:24 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-08-12 7:06 [PATCH] dt-bindings: pip command elaboration Linus Walleij
2020-08-12 16:24 ` 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).