Received-SPF: pass (google.com: domain of linux-kernel+bounces-63852-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1;
Message-ID: <ec079a72-adc7-4a33-8486-e3b624ef6ba5@ti.com>
Date: Tue, 13 Feb 2024 10:00:50 -0600
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH] docs: dt: Update overlay file extension
To: Geert Uytterhoeven <geert+renesas@glider.be>,
        Jonathan Corbet
	<corbet@lwn.net>, Alex Shi <alexs@kernel.org>,
        Yanteng Si
	<siyanteng@loongson.cn>, Rob Herring <robh@kernel.org>,
        Krzysztof Kozlowski
	<krzysztof.kozlowski+dt@linaro.org>,
        Conor Dooley <conor+dt@kernel.org>
CC: <linux-doc@vger.kernel.org>, <devicetree@vger.kernel.org>,
        <linux-kernel@vger.kernel.org>
References: <5ac79104822cdce7a4caab87f14ce02477f85820.1707819511.git.geert+renesas@glider.be>
Content-Language: en-US
From: Andrew Davis <afd@ti.com>
In-Reply-To: <5ac79104822cdce7a4caab87f14ce02477f85820.1707819511.git.geert+renesas@glider.be>
Content-Type: text/plain; charset="UTF-8"; format=flowed
Content-Transfer-Encoding: 8bit

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@glider.be>
> ---

Acked-by: Andrew Davis <afd@ti.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