Re: [PATCH] of: Fix RST inline emphasis warnings in of_map_id() kernel-doc
From: Rob Herring (Arm)
Date: Mon Jun 22 2026 - 21:46:05 EST
On Fri, 19 Jun 2026 11:16:47 +0530, Vijayanand Jitta wrote:
> The @filter_np parameter descriptions in of_map_id() and of_map_msi_id()
> contained the text '*filter_np' in prose. Docutils interprets a leading
> '*' as the start of RST emphasis (italic), but finds no closing '*',
> triggering:
>
> Documentation/devicetree/kernel-api:11: ./drivers/of/base.c:2134:
> WARNING: Inline emphasis start-string without end-string. [docutils]
>
> Documentation/devicetree/kernel-api:11: ./drivers/of/base.c:2260:
> WARNING: Inline emphasis start-string without end-string. [docutils]
>
> Fix by wrapping '*filter_np' in double backticks (*filter_np) to
> render it as an RST inline code literal, which is also the correct
> kernel-doc convention for pointer expressions.
>
> Reported-by: kernel test robot <lkp@xxxxxxxxx>
> Closes: https://lore.kernel.org/oe-kbuild-all/202606130111.ldC96rqf-lkp@xxxxxxxxx/
> Signed-off-by: Vijayanand Jitta <vijayanand.jitta@xxxxxxxxxxxxxxxx>
> ---
> drivers/of/base.c | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
Applied, thanks!