Received-SPF: pass (google.com: domain of linux-kernel+bounces-194066-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
Message-ID: <d4e4064c-e731-4721-b815-a2e30d3af513@gmail.com>
Date: Wed, 29 May 2024 20:17:21 +0800
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH v2] docs: dt: Update overlay file extension
To: Geert Uytterhoeven <geert+renesas@glider.be>,
 Rob Herring <robh@kernel.org>, Krzysztof Kozlowski <krzk+dt@kernel.org>,
 Conor Dooley <conor+dt@kernel.org>, Alex Shi <alexs@kernel.org>,
 Yanteng Si <siyanteng@loongson.cn>, Jonathan Corbet <corbet@lwn.net>,
 Andrew Davis <afd@ti.com>, Masahiro Yamada <masahiroy@kernel.org>,
 Andy Shevchenko <andriy.shevchenko@intel.com>
Cc: devicetree@vger.kernel.org, linux-doc@vger.kernel.org,
 linux-kernel@vger.kernel.org
References: <977f66b9882b6150a8da5787bf94a418aa9affec.1716976241.git.geert+renesas@glider.be>
Content-Language: en-US
From: Alex Shi <seakeel@gmail.com>
In-Reply-To: <977f66b9882b6150a8da5787bf94a418aa9affec.1716976241.git.geert+renesas@glider.be>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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@glider.be>
> Acked-by: Andrew Davis <afd@ti.com>
> Reviewed-by: Yanteng Si <siyanteng@loongson.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