From patchwork Wed Aug 12 07:06:40 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 247630 Delivered-To: patch@linaro.org Received: by 2002:a54:3b12:0:0:0:0:0 with SMTP id j18csp151996ect; Wed, 12 Aug 2020 00:06:48 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyqkK9SsKqKRiqIljrqTvtddedswHktcpt737bgxjBkxqobr9x/Z7Xcqo7Wa3KEtnkUXfga X-Received: by 2002:a50:d655:: with SMTP id c21mr28897653edj.49.1597216008110; Wed, 12 Aug 2020 00:06:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1597216008; cv=none; d=google.com; s=arc-20160816; b=QGEOGt7iciW9UmWnSWrkbfatXforLbafuhvd5kXw7WI0evYuOaRpeXR6KbeKKyPYMk avwPt3LmR4CbcJAJU1AXPkfAhERWMBKgcSwJbYD6unMi2wGTQ+8rX1umqsAeUOtocoz2 E4wbjLoiYxmu/CL53TQGHKE2E2cI1yq6oy0t92fya/PEyEbOToj+qeUWLFEKdJ4FlnTu nIiOVh9S04oRp6f3hLVN3BrFDGZFwhKlmZlfCUs5n6Fn4U8YGFKNmMqPSD2yHY9oJXAl ipLEvJIRCKBH1KrZK4P/nLnBNU+hSd7f5BjEA3B3i/anHWqrhXKPjqNcr6BQe9eWzyzc wI5w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=1K3oBY2TmVMmKmOQPQU9rGoPDuwC0BKmISYgxAAqZh0=; b=fA2q6eYPWFnz+ATIoA58lYoB0vcU+AtQ6nct022q5yPN0BMkTZ/Nyz2L6cqmXaDhJN 73t9jX2WnJgD8Jvg6qtWEn2diI12uz3zfreg/fgh7TozQx7pd0ijwjD95h6dBbOneB4H vMojfMHNTd+WU+USbQZQPt7+V6aVuhwxTAo5V/lQQEofhNuNLGkG6bpKchSTLzCVo3GQ FA1uaK8sP8Bx6XZrqDxobOyLmkmKJrEHVDTypXK2KJwfFGMi3dErWdNHc7XDtxMd0gT6 beVTjVP8I4VjibTBYZN1x6P/Y2PrJhGp1A+gGQVpxvPqgrNs8Ojc7RmL/+SKjzK1QZpk 1zSQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="sA2/JxzA"; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id f9si827247ejl.286.2020.08.12.00.06.47; Wed, 12 Aug 2020 00:06:48 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="sA2/JxzA"; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1725845AbgHLHGr (ORCPT + 6 others); Wed, 12 Aug 2020 03:06:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34844 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726572AbgHLHGr (ORCPT ); Wed, 12 Aug 2020 03:06:47 -0400 Received: from mail-lj1-x231.google.com (mail-lj1-x231.google.com [IPv6:2a00:1450:4864:20::231]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B5A7AC06174A for ; Wed, 12 Aug 2020 00:06:44 -0700 (PDT) Received: by mail-lj1-x231.google.com with SMTP id m22so1066320ljj.5 for ; Wed, 12 Aug 2020 00:06:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=1K3oBY2TmVMmKmOQPQU9rGoPDuwC0BKmISYgxAAqZh0=; b=sA2/JxzA87QKxFrPbrsRcibJjyOop9YGxHZfHVpWBOhpNgNBqF2M99mhzFO5usLltA yCCieRwGJQ/Yz1qJniQBW62M4N/xu4mtFydfjbsroic7Qefl1yGqesIC/YTD0aN0RLb7 ctNAU3Ky8WocEYoPfnwd9+KZvgo6jYRwv8PfRH6l0riaFQsbqMqlPv2aOLlDTN0wfct0 l//OWg5HMlmaT0EWOoaKeUgagXCqZuIviho+rfl31HGYSMpuXsHQwBaUKok7bhrXlefp AgXIcIMTFWzihEfQoEjqVaGgtbIgIxmp47OqxXypL9Lgs3lF6rQ13ZKlFv6n33XY16n7 iVkg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=1K3oBY2TmVMmKmOQPQU9rGoPDuwC0BKmISYgxAAqZh0=; b=IdYbwPMrwvUqOrGvuOeiXJpEaWQX5WmIutgqiGe1HQlQSlSEgFoT5Ol9lv71WnzEQm cCY5x6EnA6vTI2KlvIvC0r6A5xJ2hc7JiqPf+KO2eCDxzlM0kWvp1q5hL//LlTh7h+EA z+c+fA7WP0pkCa9N/6g7ES9c5x72rIshLlwv4pcr8m73QgZM8s175AR1clbZSc/IdDmG J8rrxN4NorClaa1ygcr0RHIGhVgzV/gSTHES318Bkq+2/KJrxmdIXk99ULGf0PNgMHla 88qWx6crU5QA7n9j2Wv1bf+qlWdT+DmASP2YDQQhDnwzuLEXM4QhLtwBapz7uiYMLdmw Y6xw== X-Gm-Message-State: AOAM533ZGg4QRLWDmS9hCL6ETYHQse5rnes6HeFMtyN9LzsqyOwJjCL8 F6BSvJpQeMbxgw4FSijQwiMd1mFX8ko= X-Received: by 2002:a2e:b00f:: with SMTP id y15mr4886274ljk.223.1597216003082; Wed, 12 Aug 2020 00:06:43 -0700 (PDT) Received: from localhost.bredbandsbolaget (c-92d7225c.014-348-6c756e10.bbcust.telenor.se. [92.34.215.146]) by smtp.gmail.com with ESMTPSA id s2sm263317lfs.4.2020.08.12.00.06.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 12 Aug 2020 00:06:42 -0700 (PDT) From: Linus Walleij To: Rob Herring , Mark Rutland Cc: devicetree@vger.kernel.org, Linus Walleij Subject: [PATCH] dt-bindings: pip command elaboration Date: Wed, 12 Aug 2020 09:06:40 +0200 Message-Id: <20200812070640.2543557-1-linus.walleij@linaro.org> X-Mailer: git-send-email 2.26.2 MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org 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 --- Documentation/devicetree/writing-schema.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) -- 2.26.2 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: