From nobody Sun Dec 14 12:11:01 2025 Received: from michel.telenet-ops.be (michel.telenet-ops.be [195.130.137.88]) (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 4680522AE65 for ; Wed, 5 Feb 2025 10:46:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=195.130.137.88 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738752409; cv=none; b=lc6mj/gLVO3lpE9RIeX53nAh0SZZOUgvObNRDt534GXgOA8i7o2HUvt1miR7I32qlSnVso3l0Kc25XaQev0sPfOOvgZ3otdBl8k/u5WxjEVeEXIqXPhbF2d9CnDePWWtrOvJS5nuiNGwIuQl0nMbm0TYyrkc9Av6M7YwRKgBvkk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738752409; c=relaxed/simple; bh=O0hJvdHYBQv3L88+Z8IQHgscfJ9XOUUdzclkUIkbU24=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=bUnk3xI/4M629MJIst1Ik8LV8DySrNTOS/EVqCOMMnCR8yuL/m+avbVWMc/ckHl5HU9tqbuqjlTrEYZGL2/zew22+SFZXM4e+b+Ij1vIO9DMfQpfRpa9f/ByGKX/QEHQzTcOxFOgfgSHxmIFc26kRuI4hgqfTDm3I5zy2V4IMBo= 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.137.88 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:c448:5c9f:5d50:ad45]) by michel.telenet-ops.be with cmsmtp id 9mmf2E00C5P95W306mmfG3; Wed, 05 Feb 2025 11:46:45 +0100 Received: from rox.of.borg ([192.168.97.57]) by ramsan.of.borg with esmtp (Exim 4.97) (envelope-from ) id 1tfcvL-0000000Fsrf-0Lau; Wed, 05 Feb 2025 11:46:39 +0100 Received: from geert by rox.of.borg with local (Exim 4.97) (envelope-from ) id 1tfcvX-00000006Ngh-0YNS; Wed, 05 Feb 2025 11:46:39 +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 3] docs: dt: Update overlay file extension Date: Wed, 5 Feb 2025 11:46:37 +0100 Message-ID: X-Mailer: git-send-email 2.43.0 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.43.0