From patchwork Mon Oct 2 18:38:12 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hugo Villeneuve X-Patchwork-Id: 147564 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2a8e:b0:403:3b70:6f57 with SMTP id in14csp1738148vqb; Mon, 2 Oct 2023 16:00:16 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGKvbKGZuv1JEArXggWo/TS+ZgJ1pAHKDqhagmcc9egQXQ8Ns5zmXKz7uj+H1PkZI8T8Ug2 X-Received: by 2002:a25:4255:0:b0:d85:e0d3:b491 with SMTP id p82-20020a254255000000b00d85e0d3b491mr11337018yba.32.1696287616314; Mon, 02 Oct 2023 16:00:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1696287616; cv=none; d=google.com; s=arc-20160816; b=Br5uqnB8hkcEp+KGyMnpajZO634fDg4MVUjOTDgo6yi2DmGNXCutc4HA8RfWKZvMc1 OpXbri1qjJUuWHWyaCMy3tj6qk7NutrFraxUbU2xj4lRcsbm0hc+KNfhL9OOfAK/RZ/y KCBiqfL5eplNorQrVwpIFGkm3SpLWSiup8nrNdX+LFcNf01fDk3544N+yhgvqYptSIJG Foa71LREV/t2ZgBfiEw+9JPoj8/cn862jIB+/k65plR9qfHbMpp16NAPceL2PAduQ/I7 MDMp3A2tu6e1fQd34pIvGVL9uQqFZQnUcbOmMNdNjIhm3SnTejuux+oG0E5/ucgaXrP4 eHdw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:subject:content-transfer-encoding:mime-version :message-id:date:cc:to:from:dkim-signature; bh=k5VmxsvhsCQHD3qaOAKUM4fWSbgtj0T8aIQI/Dh/xjE=; fh=R0Qv9NdRXVRbfKC0+epUiO4KPXnYlsBx1lAoNUNLJ3Q=; b=NritfsrHYM21jRGdC//n5shtyjxgbjBSvcAT3NhSr8HAWZMEM+MmiGD9Au32MtMVxw 8zyEzXGz4NSp5bjAz/Z7y5GbpIznIvIPHUQSVD7ZnktljhVeNsas61bOVGIcD6pegK4J RUwJWYRWE25UWHJ2vbq2xf3KWpzAkHw7UyuUeWg/w0jTwWHISD/GfairUqzv4QvEMcWs B1rjeCYoYZDy6qfx2Y4wiZ+wD00pLrdPrnFRAQFmisFLdXAmTG/rhCmIpKDN0v1PSz3o cCOBiJuTMsgHRVPlHdiBs1bWNsPdaVp//nJFP1lxw3Qzhvwg1PWn6YLnrQnCorVc1TbM tVgA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@hugovil.com header.s=x header.b=rzkH8izg; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id q26-20020a631f5a000000b005644a9be955si28658757pgm.179.2023.10.02.16.00.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Oct 2023 16:00:16 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@hugovil.com header.s=x header.b=rzkH8izg; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id B327A8104398; Mon, 2 Oct 2023 11:38:52 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S238816AbjJBSin (ORCPT + 18 others); Mon, 2 Oct 2023 14:38:43 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56430 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S238806AbjJBSig (ORCPT ); Mon, 2 Oct 2023 14:38:36 -0400 Received: from mail.hugovil.com (mail.hugovil.com [162.243.120.170]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 29945AD; Mon, 2 Oct 2023 11:38:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=hugovil.com ; s=x; h=Subject:Content-Transfer-Encoding:MIME-Version:Message-Id:Date:Cc:To :From:subject:date:message-id:reply-to; bh=k5VmxsvhsCQHD3qaOAKUM4fWSbgtj0T8aIQI/Dh/xjE=; b=rzkH8izgNXdp83B9qsa2qgLVv9 g1kWOmOPN26C4M8exKZO/XyU+ENbRP9yd+Uz3nhv6gXN3vEE2PCSJD8fYGj99UV76fyy1zWFq4IOW 3SXKBlXJymdIZOsdByyqVbvDmbczGgRjVeKbWlrVQAjeQq9nVAbuLKvcBNu/kAh77JvA=; Received: from modemcable168.174-80-70.mc.videotron.ca ([70.80.174.168]:39414 helo=pettiford.lan) by mail.hugovil.com with esmtpa (Exim 4.92) (envelope-from ) id 1qnNoI-00047v-DE; Mon, 02 Oct 2023 14:38:27 -0400 From: Hugo Villeneuve To: Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: hugo@hugovil.com, Hugo Villeneuve , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Date: Mon, 2 Oct 2023 14:38:12 -0400 Message-Id: <20231002183813.1702052-1-hugo@hugovil.com> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 X-SA-Exim-Connect-IP: 70.80.174.168 X-SA-Exim-Mail-From: hugo@hugovil.com X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 Subject: [PATCH v2] docs: dt: writing-schema: add example for multiple DT_SCHEMA_FILES X-SA-Exim-Version: 4.2.1 (built Wed, 08 May 2019 21:11:16 +0000) X-SA-Exim-Scanned: Yes (on mail.hugovil.com) Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Mon, 02 Oct 2023 11:38:52 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778311775897432031 X-GMAIL-MSGID: 1778686483491211873 From: Hugo Villeneuve Variable DT_SCHEMA_FILES can specify multiple files or patterns, but the documentation does not indicate how to do it. Each entry needs to be separated by a column symbol ':'. Add an example to make it more obvious how to specify multiple DT_SCHEMA_FILES. Signed-off-by: Hugo Villeneuve --- Link: [v1] https://lore.kernel.org/all/20230928190259.3497563-1-hugo@hugovil.com/ Changes for V2: - Change description to indicate that multiple patterns can also be specified Documentation/devicetree/bindings/writing-schema.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) base-commit: 8a749fd1a8720d4619c91c8b6e7528c0a355c0aa diff --git a/Documentation/devicetree/bindings/writing-schema.rst b/Documentation/devicetree/bindings/writing-schema.rst index 4a381d20f2b4..0a6cf19a1459 100644 --- a/Documentation/devicetree/bindings/writing-schema.rst +++ b/Documentation/devicetree/bindings/writing-schema.rst @@ -159,11 +159,14 @@ It is possible to run both in a single command:: make dt_binding_check dtbs_check It is also possible to run checks with a subset of matching schema files by -setting the ``DT_SCHEMA_FILES`` variable to a specific schema file or pattern. +setting the ``DT_SCHEMA_FILES`` variable to 1 or more specific schema files or +patterns (partial match of a fixed string). Each file or pattern should be +separated by ':'. :: make dt_binding_check DT_SCHEMA_FILES=trivial-devices.yaml + make dt_binding_check DT_SCHEMA_FILES=trivial-devices.yaml:rtc.yaml make dt_binding_check DT_SCHEMA_FILES=/gpio/ make dtbs_check DT_SCHEMA_FILES=trivial-devices.yaml