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@xxxxxxxxxx> --- 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
