linux-kernel - Re: [PATCH] docs: dt: Update overlay file extension

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Date: Tue, 13 Feb 2024 10:00:50 -0600
From: Andrew Davis <afd@...com>
To: Geert Uytterhoeven <geert+renesas@...der.be>,
        Jonathan Corbet
	<corbet@....net>, Alex Shi <alexs@...nel.org>,
        Yanteng Si
	<siyanteng@...ngson.cn>, Rob Herring <robh@...nel.org>,
        Krzysztof Kozlowski
	<krzysztof.kozlowski+dt@...aro.org>,
        Conor Dooley <conor+dt@...nel.org>
CC: <linux-doc@...r.kernel.org>, <devicetree@...r.kernel.org>,
        <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH] docs: dt: Update overlay file extension

On 2/13/24 4:24 AM, Geert Uytterhoeven wrote:
> 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 <geert+renesas@...der.be>
> ---

Acked-by: Andrew Davis <afd@...com>

>   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/devicetree/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 ---------------------------------------------------------------
>   
> -The overlay bar.dts,
> +The overlay bar.dtso,
>   ::
>   
> -    ---- 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 --------------------------------------------------------------
>   
>   when loaded (and resolved as described in [1]) should result in foo+bar.dts::
>   
> @@ -88,9 +88,9 @@ in the base DT. In this case, the target path can be provided. 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.
>   
> -The above bar.dts example modified to use target path syntax is::
> +The above bar.dtso example modified to use target path syntax is::
>   
> -    ---- 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 syntax is::
>   			... /* various properties and child nodes */
>   		}
>   	};
> -    ---- bar.dts ---------------------------------------------------------------
> +    ---- bar.dtso --------------------------------------------------------------
>   
>   
>   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]的配套文档。
>   	};
>       ---- foo.dts ---------------------------------------------------------------
>   
> -覆盖bar.dts,
> +覆盖bar.dtso,
>   ::
>   
> -    ---- bar.dts - 按标签覆盖目标位置 ----------------------------
> +    ---- bar.dtso - 按标签覆盖目标位置 ---------------------------
>   	/dts-v1/;
>   	/插件/;
>   	&ocp {
> @@ -56,7 +56,7 @@ Documentation/devicetree/dynamic-resolution-notes.rst[1]的配套文档。
>   			... /* 各种属性和子节点 */
>   		};
>   	};
> -    ---- bar.dts ---------------------------------------------------------------
> +    ---- bar.dtso --------------------------------------------------------------
>   
>   当加载（并按照[1]中描述的方式解决）时，应该产生foo+bar.dts::
>   
> @@ -90,9 +90,9 @@ Documentation/devicetree/dynamic-resolution-notes.rst[1]的配套文档。
>   DT中的适当位置。在这种情况下，可以提供目标路径。通过标签的目标位置的语法是比
>   较好的，因为不管标签在DT中出现在哪里，覆盖都可以被应用到任何包含标签的基础DT上。
>   
> -上面的bar.dts例子被修改为使用目标路径语法，即为::
> +上面的bar.dtso例子被修改为使用目标路径语法，即为::
>   
> -    ---- bar.dts - 通过明确的路径覆盖目标位置 --------------------
> +    ---- bar.dtso - 通过明确的路径覆盖目标位置 -------------------
>   	/dts-v1/;
>   	/插件/;
>   	&{/ocp} {
> @@ -102,7 +102,7 @@ DT中的适当位置。在这种情况下，可以提供目标路径。通过标
>   			... /* 各种外围设备和子节点 */
>   		}
>   	};
> -    ---- bar.dts ---------------------------------------------------------------
> +    ---- bar.dtso --------------------------------------------------------------
>   
>   
>   内核中关于覆盖的API