From patchwork Fri Dec 29 05:47:11 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?b?UmFmYcWCIE1pxYJlY2tp?= X-Patchwork-Id: 183853 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:6f82:b0:100:9c79:88ff with SMTP id tb2csp2398538dyb; Thu, 28 Dec 2023 21:48:35 -0800 (PST) X-Google-Smtp-Source: AGHT+IHDYbiVcmiojkkM+5fJQV468bc+MRJWfYQOwcNYWHiWbPzpOI+yjnTiPjdL9ODbwR6F5Nk+ X-Received: by 2002:a17:902:6505:b0:1d3:d9e3:2d9d with SMTP id b5-20020a170902650500b001d3d9e32d9dmr4746038plk.126.1703828915609; Thu, 28 Dec 2023 21:48:35 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1703828915; cv=none; d=google.com; s=arc-20160816; b=UJs7NU4sBRjXjoUlUrcGKhRGiiTIIKu1DeK7W1Wnp0THJqYjA0+vTIdK+YZ75XdqSC 1bBbiPilDvgaoVgPWLSZAOF3ua5wgmqYmdwAREuzPLggHKza0AzDqeuVZAWz9uGIw297 T5r+iN6lHm2HJd7quBvBPZojC+YQAoTcXX5yEi7dKRz/8pE5iG+gKhGR1GLafcJTYuQE QqqA4uYEVYntLWpYXMZFX2obMPoENzKqDUqbsDVKeyg9KvMxrzUsaEJ9VGI2fj0fNhGS RLbmVFzAtHNRytYTVKZMIzznwWwCoURCpURn2D5m5W/z8bCgUcO+cPX8baSuXnJArOPi a3UA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=ClpHT/yJDzsGfgCrD6c+GMtCBr/uPP1onuzKC8VSZQ4=; fh=bfcxYZggtze7TY8pwi1DVCUaAudMOIrUDS+xej3a9fs=; b=a+QmZlMWukTTdW/JXlI7iwvtADfsjYNGFy3WYa+dRZhdAXZh9gxHokksyg9UI3k9tN +CajlWolwqM3TCT58HW4NZbhGu60il9GgtNOuMsZE/9qSVMsWFy2fHM2/E1YkF77n1El dnbNWHcWmDNM2raBh8zjRyqy4XXZKIs/hvKmmj7o/8JhSr+T9lwpCSH+5sKEabfVGvwM kyCyidtgQCx3OS8/bRDRJzN2syWVbOn0J0wJ+Jkivx+irB2OF4db5122PG0JMJlAvPJA 482KMe5DP13is5Zz/owgaIr3nxLhcWXOwVF6wZ+OGApXfaQYz3ejJRGmYriXvK11Oxt2 G8xQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=CpF5Y2Yv; spf=pass (google.com: domain of linux-kernel+bounces-12948-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-12948-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id l17-20020a170902f69100b001d2eb1a4f12si14507976plg.233.2023.12.28.21.48.35 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 28 Dec 2023 21:48:35 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-12948-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=CpF5Y2Yv; spf=pass (google.com: domain of linux-kernel+bounces-12948-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-12948-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id 33E72B23AA5 for ; Fri, 29 Dec 2023 05:48:26 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B2D19612A; Fri, 29 Dec 2023 05:48:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="CpF5Y2Yv" X-Original-To: linux-kernel@vger.kernel.org Received: from mail-ej1-f49.google.com (mail-ej1-f49.google.com [209.85.218.49]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7E3F523A1; Fri, 29 Dec 2023 05:48:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-ej1-f49.google.com with SMTP id a640c23a62f3a-a26fa294e56so327146566b.0; Thu, 28 Dec 2023 21:48:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1703828883; x=1704433683; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=ClpHT/yJDzsGfgCrD6c+GMtCBr/uPP1onuzKC8VSZQ4=; b=CpF5Y2YvIkzoEK+lve9nIwn+8tiQ2HYyy5S1YEQjwyoc9bCo79Lm24stYhkrcH7tzW WgYMIYqhHIOqV5X59Bp9Q8Uy/JKd3WIaShK6d8o8fB3z27RLJ+bjA+I6zRm5Z/sf8u/N t2bxSxA8hYw+c6KNtAsjJm6Ln7MbN+PMfGnkF13WISoOvNQ68hwTAGJRI2IBQj0OQAZi NkGNNwNVwtP8sxlxIxn/vYuZ0U4RAWjMaZNvTGovfkxy+XWkq5V5mqvqBeBzT0g20CC/ nKPcP1vY2P6XpXiJectefdR1Ue8n/2xuvi+ll2V5GjEllFV638hKITeaa96Has9jf+vF /nyQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1703828883; x=1704433683; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=ClpHT/yJDzsGfgCrD6c+GMtCBr/uPP1onuzKC8VSZQ4=; b=Fq/duKHs/43RTB4wkb4YDXdwipvzZXMYIzCT/Y2xYi+Kb4tjHIKQ5TkYy0PZ7Nndi9 lpSbkwj/pRbQNAaD2TCMEu1Vs9aodDZzLDwLrYOk8kunlsHheQ8fAHggxG4U2AoHf859 vIvO0f3q5Hh9QRDjnrxa4uiBLYRu7drbmmH79P41X5TaQjLHBchdELapknW/tBL4YrRb Q5DVaD8ZSqFT5ibby7Jnl4+/7PVbEHz4VlZR2i4ax3YAGQWxoZ9JeQBegFmZVcZ3uYvM TFJ+LKeCuAVMBksMk/e50RD4uIitn33CshEmCABhEDg0TL7QA1lrKAUkNOO0eWzevmtK d8ag== X-Gm-Message-State: AOJu0YwWWZMqFBpVMPjzC5WJ43i6jSs+N5U0oKbMJUUL9LqkFuAq+SEo sUh4Py2XnfSUXb9eiJ0b/r4= X-Received: by 2002:a17:906:b114:b0:a27:59a2:93fc with SMTP id u20-20020a170906b11400b00a2759a293fcmr1726278ejy.107.1703828882565; Thu, 28 Dec 2023 21:48:02 -0800 (PST) Received: from localhost.lan (031011218106.poznan.vectranet.pl. [31.11.218.106]) by smtp.gmail.com with ESMTPSA id e17-20020a170906505100b00a26ade46618sm7230880ejk.99.2023.12.28.21.48.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 28 Dec 2023 21:48:02 -0800 (PST) From: =?utf-8?b?UmFmYcWCIE1pxYJlY2tp?= To: Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: Geert Uytterhoeven , Konrad Dybcio , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, =?utf-8?b?UmFmYcWC?= =?utf-8?b?IE1pxYJlY2tp?= , Andrew Davis , Andrew Lunn , AngeloGioacchino Del Regno , Arnd Bergmann , Bjorn Andersson , Chen-Yu Tsai , Dmitry Baryshkov , Jonathan Corbet , Matthias Brugger , Michal Simek , Neil Armstrong , Nishanth Menon , Olof Johansson Subject: [PATCH] docs: dt-bindings: suggest "reg-names" position in DTS Coding Style Date: Fri, 29 Dec 2023 06:47:11 +0100 Message-Id: <20231229054711.17317-1-zajec5@gmail.com> X-Mailer: git-send-email 2.35.3 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1786594108851571040 X-GMAIL-MSGID: 1786594108851571040 From: Rafał Miłecki Property "reg-names" is strictly related to "reg" so it should follow it directly instead of falling into "Standard/common properties". This helps reading DTS files. Cc: Andrew Davis cc: Andrew Lunn Cc: AngeloGioacchino Del Regno Cc: Arnd Bergmann Cc: Bjorn Andersson Cc: Chen-Yu Tsai Cc: Dmitry Baryshkov Cc: Jonathan Corbet Cc: Matthias Brugger Cc: Michal Simek Cc: Neil Armstrong Cc: Nishanth Menon Cc: Olof Johansson Signed-off-by: Rafał Miłecki --- .../devicetree/bindings/dts-coding-style.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/Documentation/devicetree/bindings/dts-coding-style.rst b/Documentation/devicetree/bindings/dts-coding-style.rst index a9bdd2b59dca..1a48e2ca80e9 100644 --- a/Documentation/devicetree/bindings/dts-coding-style.rst +++ b/Documentation/devicetree/bindings/dts-coding-style.rst @@ -116,12 +116,13 @@ The following order of properties in device nodes is preferred: 1. "compatible" 2. "reg" -3. "ranges" -4. Standard/common properties (defined by common bindings, e.g. without +3. "reg-names" +4. "ranges" +5. Standard/common properties (defined by common bindings, e.g. without vendor-prefixes) -5. Vendor-specific properties -6. "status" (if applicable) -7. Child nodes, where each node is preceded with a blank line +6. Vendor-specific properties +7. "status" (if applicable) +8. Child nodes, where each node is preceded with a blank line The "status" property is by default "okay", thus it can be omitted.