linux-kernel - Re: [PATCH] docs: nouveau: remove invalid kernel-doc reference to r535.c

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]

Message-ID: <217e3774-8a28-4adc-b2df-a31b6ba5a382@infradead.org>
Date: Sun, 15 Jun 2025 20:04:56 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: HyeonSu Jeon <dev.hyeonsu.jeon@...il.com>,
 maarten.lankhorst@...ux.intel.com, mripard@...nel.org, airlied@...il.com,
 simona@...ll.ch, corbet@....net
Cc: dri-devel@...ts.freedesktop.org, linux-doc@...r.kernel.org,
 linux-kernel@...r.kernel.org
Subject: Re: [PATCH] docs: nouveau: remove invalid kernel-doc reference to
 r535.c

Hi,

On 6/15/25 7:17 PM, HyeonSu Jeon wrote:
> The file drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c does not exist
> in the tree, but is referenced in gsp.rst via a kernel-doc directive.
> This causes an error during the documentation build
> 
> Removing this refernce resolves the error
> 
> Signed-off-by: HyeonSu Jeon <dev.hyeonsu.jeon@...il.com>

Thanks for your patch.
A previous patch has already been applied to drm-misc-fixes:

https://lore.kernel.org/linux-doc/20250611020805.22418-2-bagasdotme@gmail.com/

> ---
>  Documentation/gpu/nouveau.rst | 3 ---
>  1 file changed, 3 deletions(-)
> 
> diff --git a/Documentation/gpu/nouveau.rst b/Documentation/gpu/nouveau.rst
> index b8c801e0068c..cab4a8eda850 100644
> --- a/Documentation/gpu/nouveau.rst
> +++ b/Documentation/gpu/nouveau.rst
> @@ -25,8 +25,5 @@ providing a consistent API to upper layers of the driver stack.
>  GSP Support
>  ------------------------
>  
> -.. kernel-doc:: drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c
> -   :doc: GSP message queue element
> -
>  .. kernel-doc:: drivers/gpu/drm/nouveau/include/nvkm/subdev/gsp.h
>     :doc: GSP message handling policy

-- 
~Randy