From nobody Sun Dec 14 12:16:12 2025 Received: from andre.telenet-ops.be (andre.telenet-ops.be [195.130.132.53]) (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 CA00920E6EB for ; Thu, 12 Dec 2024 09:01:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=195.130.132.53 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733994091; cv=none; b=MbIuNkEiD648cfmTN+wSf7M/7Ksh4HwRkSEylktACdftUyOKsiN0v16gixtASJYr7uNvZd2YRmQpJM5TW9LWLWLhvgSz6VIffWyW+uu9eHEuP9oKbQNX5p65xUMKhK+cPkHpiVAvhJTeonnYUFNI/cs23PlWEtGI3XZT9ovRXqw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733994091; c=relaxed/simple; bh=j15g7+Zs11MXgNdFt9xjPzQq0JE/TjMvjYfFKO5EiIg=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version:Content-Type; b=bVwbAM3GjEhIK6JF2EtULdvNZGPkaLDLKFw0MRulX6jILSantTZnPR3kNlzIZ01sLXB9Z6rancmAJC5owDyQtIX7t4PUbWUwNJq/g2HnK3tiyYO7eHxTMR76EVczG/KYbj0lwAdt9l9PqjgQYFmztB+ha9wRvbDJPTbUmfhfQKo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=glider.be; spf=none smtp.mailfrom=linux-m68k.org; arc=none smtp.client-ip=195.130.132.53 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=glider.be Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=linux-m68k.org Received: from ramsan.of.borg ([IPv6:2a02:1810:ac12:ed80:a086:deff:83e6:222b]) by andre.telenet-ops.be with cmsmtp id nl1E2D0091T2bNC01l1E1c; Thu, 12 Dec 2024 10:01:20 +0100 Received: from rox.of.borg ([192.168.97.57]) by ramsan.of.borg with esmtp (Exim 4.95) (envelope-from ) id 1tLf4J-000pxW-F0; Thu, 12 Dec 2024 10:01:14 +0100 Received: from geert by rox.of.borg with local (Exim 4.95) (envelope-from ) id 1tLf4H-00DEXi-0G; Thu, 12 Dec 2024 10:01:09 +0100 From: Geert Uytterhoeven To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Alex Shi , Yanteng Si , Jonathan Corbet , Andrew Davis , Andy Shevchenko , Masahiro Yamada Cc: devicetree@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Geert Uytterhoeven , Yanteng Si Subject: [PATCH v2 resend 2] docs: dt: Update overlay file extension Date: Thu, 12 Dec 2024 10:01:07 +0100 Message-Id: X-Mailer: git-send-email 2.34.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Building DTB overlays from .dts files is no longer supported. Update the documentation to reflect this. Fixes: 81d362732bac05f6 ("kbuild: Disallow DTB overlays to built from .dts = named source files") Signed-off-by: Geert Uytterhoeven Acked-by: Andrew Davis Reviewed-by: Yanteng Si --- v2: - Add Acked-by, Reviewed-by. --- Documentation/devicetree/overlay-notes.rst | 12 ++++++------ .../translations/zh_CN/devicetree/overlay-notes.rst | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/Documentation/devicetree/overlay-notes.rst b/Documentation/dev= icetree/overlay-notes.rst index e139f22b363e9f36..35e79242af9a928d 100644 --- a/Documentation/devicetree/overlay-notes.rst +++ b/Documentation/devicetree/overlay-notes.rst @@ -38,10 +38,10 @@ Lets take an example where we have a foo board with the= following base tree:: }; ---- foo.dts ---------------------------------------------------------= ------ =20 -The overlay bar.dts, +The overlay bar.dtso, :: =20 - ---- bar.dts - overlay target location by label ----------------------= ------ + ---- bar.dtso - overlay target location by label ---------------------= ------ /dts-v1/; /plugin/; &ocp { @@ -51,7 +51,7 @@ The overlay bar.dts, ... /* various properties and child nodes */ }; }; - ---- bar.dts ---------------------------------------------------------= ------ + ---- bar.dtso --------------------------------------------------------= ------ =20 when loaded (and resolved as described in [1]) should result in foo+bar.dt= s:: =20 @@ -88,9 +88,9 @@ in the base DT. In this case, the target path can be prov= ided. The target location by label syntax is preferred because the overlay can be applied to any base DT containing the label, no matter where the label occurs in the = DT. =20 -The above bar.dts example modified to use target path syntax is:: +The above bar.dtso example modified to use target path syntax is:: =20 - ---- bar.dts - overlay target location by explicit path --------------= ------ + ---- bar.dtso - overlay target location by explicit path -------------= ------ /dts-v1/; /plugin/; &{/ocp} { @@ -100,7 +100,7 @@ The above bar.dts example modified to use target path s= yntax is:: ... /* various properties and child nodes */ } }; - ---- bar.dts ---------------------------------------------------------= ------ + ---- bar.dtso --------------------------------------------------------= ------ =20 =20 Overlay in-kernel API diff --git a/Documentation/translations/zh_CN/devicetree/overlay-notes.rst = b/Documentation/translations/zh_CN/devicetree/overlay-notes.rst index 43e3c0bc5a9f8235..ba5edd05dc1e7fd2 100644 --- a/Documentation/translations/zh_CN/devicetree/overlay-notes.rst +++ b/Documentation/translations/zh_CN/devicetree/overlay-notes.rst @@ -43,10 +43,10 @@ Documentation/devicetree/dynamic-resolution-notes.rst[1= ]=E7=9A=84=E9=85=8D=E5=A5=97=E6=96=87=E6=A1=A3=E3=80=82 }; ---- foo.dts ---------------------------------------------------------= ------ =20 -=E8=A6=86=E7=9B=96bar.dts, +=E8=A6=86=E7=9B=96bar.dtso, :: =20 - ---- bar.dts - =E6=8C=89=E6=A0=87=E7=AD=BE=E8=A6=86=E7=9B=96=E7=9B=AE= =E6=A0=87=E4=BD=8D=E7=BD=AE ---------------------------- + ---- bar.dtso - =E6=8C=89=E6=A0=87=E7=AD=BE=E8=A6=86=E7=9B=96=E7=9B=AE= =E6=A0=87=E4=BD=8D=E7=BD=AE --------------------------- /dts-v1/; /=E6=8F=92=E4=BB=B6/; &ocp { @@ -56,7 +56,7 @@ Documentation/devicetree/dynamic-resolution-notes.rst[1]= =E7=9A=84=E9=85=8D=E5=A5=97=E6=96=87=E6=A1=A3=E3=80=82 ... /* =E5=90=84=E7=A7=8D=E5=B1=9E=E6=80=A7=E5=92=8C=E5=AD=90=E8=8A=82= =E7=82=B9 */ }; }; - ---- bar.dts ---------------------------------------------------------= ------ + ---- bar.dtso --------------------------------------------------------= ------ =20 =E5=BD=93=E5=8A=A0=E8=BD=BD=EF=BC=88=E5=B9=B6=E6=8C=89=E7=85=A7[1]=E4=B8= =AD=E6=8F=8F=E8=BF=B0=E7=9A=84=E6=96=B9=E5=BC=8F=E8=A7=A3=E5=86=B3=EF=BC=89= =E6=97=B6=EF=BC=8C=E5=BA=94=E8=AF=A5=E4=BA=A7=E7=94=9Ffoo+bar.dts:: =20 @@ -90,9 +90,9 @@ Documentation/devicetree/dynamic-resolution-notes.rst[1]= =E7=9A=84=E9=85=8D=E5=A5=97=E6=96=87=E6=A1=A3=E3=80=82 DT=E4=B8=AD=E7=9A=84=E9=80=82=E5=BD=93=E4=BD=8D=E7=BD=AE=E3=80=82=E5=9C=A8= =E8=BF=99=E7=A7=8D=E6=83=85=E5=86=B5=E4=B8=8B=EF=BC=8C=E5=8F=AF=E4=BB=A5=E6= =8F=90=E4=BE=9B=E7=9B=AE=E6=A0=87=E8=B7=AF=E5=BE=84=E3=80=82=E9=80=9A=E8=BF= =87=E6=A0=87=E7=AD=BE=E7=9A=84=E7=9B=AE=E6=A0=87=E4=BD=8D=E7=BD=AE=E7=9A=84= =E8=AF=AD=E6=B3=95=E6=98=AF=E6=AF=94 =E8=BE=83=E5=A5=BD=E7=9A=84=EF=BC=8C=E5=9B=A0=E4=B8=BA=E4=B8=8D=E7=AE=A1= =E6=A0=87=E7=AD=BE=E5=9C=A8DT=E4=B8=AD=E5=87=BA=E7=8E=B0=E5=9C=A8=E5=93=AA= =E9=87=8C=EF=BC=8C=E8=A6=86=E7=9B=96=E9=83=BD=E5=8F=AF=E4=BB=A5=E8=A2=AB=E5= =BA=94=E7=94=A8=E5=88=B0=E4=BB=BB=E4=BD=95=E5=8C=85=E5=90=AB=E6=A0=87=E7=AD= =BE=E7=9A=84=E5=9F=BA=E7=A1=80DT=E4=B8=8A=E3=80=82 =20 -=E4=B8=8A=E9=9D=A2=E7=9A=84bar.dts=E4=BE=8B=E5=AD=90=E8=A2=AB=E4=BF=AE=E6= =94=B9=E4=B8=BA=E4=BD=BF=E7=94=A8=E7=9B=AE=E6=A0=87=E8=B7=AF=E5=BE=84=E8=AF= =AD=E6=B3=95=EF=BC=8C=E5=8D=B3=E4=B8=BA:: +=E4=B8=8A=E9=9D=A2=E7=9A=84bar.dtso=E4=BE=8B=E5=AD=90=E8=A2=AB=E4=BF=AE=E6= =94=B9=E4=B8=BA=E4=BD=BF=E7=94=A8=E7=9B=AE=E6=A0=87=E8=B7=AF=E5=BE=84=E8=AF= =AD=E6=B3=95=EF=BC=8C=E5=8D=B3=E4=B8=BA:: =20 - ---- bar.dts - =E9=80=9A=E8=BF=87=E6=98=8E=E7=A1=AE=E7=9A=84=E8=B7=AF= =E5=BE=84=E8=A6=86=E7=9B=96=E7=9B=AE=E6=A0=87=E4=BD=8D=E7=BD=AE -----------= --------- + ---- bar.dtso - =E9=80=9A=E8=BF=87=E6=98=8E=E7=A1=AE=E7=9A=84=E8=B7=AF= =E5=BE=84=E8=A6=86=E7=9B=96=E7=9B=AE=E6=A0=87=E4=BD=8D=E7=BD=AE -----------= -------- /dts-v1/; /=E6=8F=92=E4=BB=B6/; &{/ocp} { @@ -102,7 +102,7 @@ DT=E4=B8=AD=E7=9A=84=E9=80=82=E5=BD=93=E4=BD=8D=E7=BD= =AE=E3=80=82=E5=9C=A8=E8=BF=99=E7=A7=8D=E6=83=85=E5=86=B5=E4=B8=8B=EF=BC=8C= =E5=8F=AF=E4=BB=A5=E6=8F=90=E4=BE=9B=E7=9B=AE=E6=A0=87=E8=B7=AF=E5=BE=84=E3= =80=82=E9=80=9A=E8=BF=87=E6=A0=87 ... /* =E5=90=84=E7=A7=8D=E5=A4=96=E5=9B=B4=E8=AE=BE=E5=A4=87=E5=92=8C= =E5=AD=90=E8=8A=82=E7=82=B9 */ } }; - ---- bar.dts ---------------------------------------------------------= ------ + ---- bar.dtso --------------------------------------------------------= ------ =20 =20 =E5=86=85=E6=A0=B8=E4=B8=AD=E5=85=B3=E4=BA=8E=E8=A6=86=E7=9B=96=E7=9A=84API --=20 2.34.1