linux-kernel - Re: [PATCH v2] 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] [day] [month] [year] [list]
Date: Wed, 29 May 2024 20:17:21 +0800
From: Alex Shi <seakeel@...il.com>
To: Geert Uytterhoeven <geert+renesas@...der.be>,
 Rob Herring <robh@...nel.org>, Krzysztof Kozlowski <krzk+dt@...nel.org>,
 Conor Dooley <conor+dt@...nel.org>, Alex Shi <alexs@...nel.org>,
 Yanteng Si <siyanteng@...ngson.cn>, Jonathan Corbet <corbet@....net>,
 Andrew Davis <afd@...com>, Masahiro Yamada <masahiroy@...nel.org>,
 Andy Shevchenko <andriy.shevchenko@...el.com>
Cc: devicetree@...r.kernel.org, linux-doc@...r.kernel.org,
 linux-kernel@...r.kernel.org
Subject: Re: [PATCH v2] docs: dt: Update overlay file extension

LGTM.

On 5/29/24 6:00 PM, 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>
> Reviewed-by: Yanteng Si <siyanteng@...ngson.cn>
> ---
> 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/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