linux-kernel - Re: [PATCH] Documentation/printf: Use literal fwnode

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]

Message-ID: <d28f89df-5a12-4b81-99e3-09bb0cbbf9aa@linux.dev>
Date: Mon, 11 Aug 2025 16:28:24 +0800
From: Kunwu Chan <kunwu.chan@...ux.dev>
To: Geert Uytterhoeven <geert+renesas@...der.be>,
 Petr Mladek <pmladek@...e.com>, Steven Rostedt <rostedt@...dmis.org>,
 Andy Shevchenko <andriy.shevchenko@...ux.intel.com>,
 Rasmus Villemoes <linux@...musvillemoes.dk>,
 Sergey Senozhatsky <senozhatsky@...omium.org>,
 Jonathan Corbet <corbet@....net>
Cc: linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] Documentation/printf: Use literal fwnode_handle

On 2025/8/7 15:36, Geert Uytterhoeven wrote:
> When looking for fwnode_handle in the printk format documentation, it is
> only found in the Chinese translation:
>
>      $ git grep fwnode_handle -- Documentation/*printk-formats.rst
>      Documentation/translations/zh_CN/core-api/printk-formats.rst:用于打印fwnode_handles的消息。默认情况下是打印完整的节点名称，包括路径。
>
> This happens because the original documentation talks about "fwnode
> handles", without mentioning the actual type name.
>
> Signed-off-by: Geert Uytterhoeven <geert+renesas@...der.be>
> ---
>   Documentation/core-api/printk-formats.rst | 2 +-
>   1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/core-api/printk-formats.rst b/Documentation/core-api/printk-formats.rst
> index 4b7f3646ec6ce028..7f2f11b482865175 100644
> --- a/Documentation/core-api/printk-formats.rst
> +++ b/Documentation/core-api/printk-formats.rst
> @@ -521,7 +521,7 @@ Fwnode handles
>   
>   	%pfw[fP]
>   
> -For printing information on fwnode handles. The default is to print the full
> +For printing information on an fwnode_handle. The default is to print the full
>   node name, including the path. The modifiers are functionally equivalent to
>   %pOF above.
>   

Thanks for the patch.

After apply this patch, test result:

#  git grep fwnode_handle -- Documentation/*printk-formats.rst
Documentation/core-api/printk-formats.rst:For printing information on an 
fwnode_handle. The default is to print the full
Documentation/translations/zh_CN/core-api/printk-formats.rst:用于打印fwnode_handles的消息。默认情况下是
打印完整的节点名称，包括路径。
#

Tested-by: Kunwu Chan <kunwu.chan@...ux.dev>

Reviewed-by: Kunwu Chan <kunwu.chan@...ux.dev>


-- 
Thanks,
        Kunwu Chan.