From patchwork Tue Oct 15 15:54:32 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Rob Herring \(Arm\)" X-Patchwork-Id: 176380 Delivered-To: patch@linaro.org Received: by 2002:a92:7e96:0:0:0:0:0 with SMTP id q22csp6096661ill; Tue, 15 Oct 2019 08:54:37 -0700 (PDT) X-Google-Smtp-Source: APXvYqzNxDaeAYpzWyYAR5N4p6LEhV/95/qJMrOmUDT5vQ1huzWD+PqelBRDT9pElgSqKkkbB14x X-Received: by 2002:a17:906:cd11:: with SMTP id oz17mr35040620ejb.71.1571154876930; Tue, 15 Oct 2019 08:54:36 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1571154876; cv=none; d=google.com; s=arc-20160816; b=mej8Wf96sS5B5MZFRr6pmlJCCZOB7WjyTziNo1bejzK6zUzpzSrW3S7tfd8WyWLB2P z8L3vxLWXe3aW6JEADbfFY6d0iCVVAY1H+QBRYmeygBcov65Blvsdg4VgDUq6NVuKzEU +njWhWc1nwSJSziz7XymE1nc1+YTsjOU4M88KvFu19A648w0SDRoNS8wQ0uUub+XkKQc aRwrkk7wB6MadEt4p7NhyKcvvSU7g77on0Z/N2TKkcUQRFN0ppgfex+JyqBi+EPjZC2Y kWTpFqBWgSuLFZpUXYCeye9Ti/ClR/XAe84Wf1gcF+/FWIgOVLEZCdVntAypKm+Dkwwi Zwqg== 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; bh=+qhKK3H7JHx9Pg9rqpVbjQ8Fqzdg622NRYKtEz3pOpY=; b=SwWFpiA6ydyAsRxOZRKFq1wjxEDQoYiKdaVe45LaNOF6wg0cQxQDRWliRNzSHz9Woe 9bdRADFfV2p41WLf7w62Nnzs0EBnBDXnEBAC2r0kwgR7gKu4m3N8/xBnUHO/BqEdjWVr 2ufsoDZtxMtNmkroV/Nxvn7wCNyQpg11eNvjHzpztR3JKGdKWVP2c4aX5ZpXPl6YxL7w JQ0un5KGEAUUF8Jjat++3++a9gZ3Yw6Or633IfylHZgVBExdOKcQzMksf+s2xM+cyWxo iK153eBC0DlcNQni4EmXKd5RoPtNR1rdF3pdfypzFoxIbj++1XwPvZQLqIKomMU7x2V6 osgw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id s7si15707824edm.74.2019.10.15.08.54.36; Tue, 15 Oct 2019 08:54:36 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1732659AbfJOPyg (ORCPT + 8 others); Tue, 15 Oct 2019 11:54:36 -0400 Received: from mail-ot1-f68.google.com ([209.85.210.68]:42729 "EHLO mail-ot1-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728197AbfJOPyg (ORCPT ); Tue, 15 Oct 2019 11:54:36 -0400 Received: by mail-ot1-f68.google.com with SMTP id c10so17371548otd.9; Tue, 15 Oct 2019 08:54:35 -0700 (PDT) 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=+qhKK3H7JHx9Pg9rqpVbjQ8Fqzdg622NRYKtEz3pOpY=; b=UM+NOX/2ooHc5rvjlcwZPc5pvWMlxN2Vl0/JHZ8Xua+GefiYLwD/2a10/81nuKFQ/L 8rGMhMnaWmHeS2vBJujMfbwJ0AtLBMim7MI5Vz63Jn+C4HM2NeYVPgnRjrWmaUMy0zYW nbIiH72KmM86XKZgh/yKKsbo1nJwk6C/pzgG43u9UimqstpgniCLyer1YYRYiKjM9icI HtwtgcwHfK2EWeneuKB/JfdP7WDKeVB+GiMZugtBPy6HKrvqK6UaMQUv4Tirn/w8oPZu VZ/BUCMqtL+QbnKCAboua2bttpO/WKPMxp3RITHvC37qegqt8QaK2qKzFhRvVJqgbhDi NmRQ== X-Gm-Message-State: APjAAAUoWR20xcNVsYCTYewcmEzA4lIH9RWWPkknCZZaA4taMjplDPQr UOpna3AO2Ml+94P7Llf3K6/5C5o= X-Received: by 2002:a9d:7d16:: with SMTP id v22mr1008454otn.331.1571154874589; Tue, 15 Oct 2019 08:54:34 -0700 (PDT) Received: from xps15.herring.priv (24-155-109-49.dyn.grandenetworks.net. [24.155.109.49]) by smtp.googlemail.com with ESMTPSA id y137sm6633719oie.53.2019.10.15.08.54.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 15 Oct 2019 08:54:34 -0700 (PDT) From: Rob Herring To: devicetree@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Robert Jones Subject: [PATCH 1/2] dt: writing-schema: Add a note about tools PATH setup Date: Tue, 15 Oct 2019 10:54:32 -0500 Message-Id: <20191015155433.25359-1-robh@kernel.org> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Users without an existing python install may not have their PATH setup for pip installed python programs already. Add a note about having the DT validation programs in the PATH. Reported-by: Robert Jones Signed-off-by: Rob Herring --- Documentation/devicetree/writing-schema.rst | 3 +++ 1 file changed, 3 insertions(+) -- 2.20.1 diff --git a/Documentation/devicetree/writing-schema.rst b/Documentation/devicetree/writing-schema.rst index f4a638072262..3fce61cfd649 100644 --- a/Documentation/devicetree/writing-schema.rst +++ b/Documentation/devicetree/writing-schema.rst @@ -117,6 +117,9 @@ project can be installed with pip:: pip3 install 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). + dtc must also be built with YAML output support enabled. This requires that libyaml and its headers be installed on the host system.