linux-kernel - Re: [Linaro-mm-sig] [PATCH 09/14] drm/amd/display: Don't use kernel-doc comment in dc_register_software

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: <CADnq5_NsELxchDeka2CX1283p9mn4+P9_V9Mi+SNiWwM_sQepw@mail.gmail.com>
Date: Tue, 16 Dec 2025 10:21:18 -0500
From: Alex Deucher <alexdeucher@...il.com>
To: Bagas Sanjaya <bagasdotme@...il.com>
Cc: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>, 
	Linux AMDGPU <amd-gfx@...ts.freedesktop.org>, 
	Linux DRI Development <dri-devel@...ts.freedesktop.org>, 
	Linux Filesystems Development <linux-fsdevel@...r.kernel.org>, Linux Media <linux-media@...r.kernel.org>, 
	linaro-mm-sig@...ts.linaro.org, kasan-dev@...glegroups.com, 
	Linux Virtualization <virtualization@...ts.linux.dev>, 
	Linux Memory Management List <linux-mm@...ck.org>, Linux Network Bridge <bridge@...ts.linux.dev>, 
	Linux Networking <netdev@...r.kernel.org>, Harry Wentland <harry.wentland@....com>, 
	Leo Li <sunpeng.li@....com>, Rodrigo Siqueira <siqueira@...lia.com>, 
	Alex Deucher <alexander.deucher@....com>, Christian König <christian.koenig@....com>, 
	Simona Vetter <simona@...ll.ch>, Maarten Lankhorst <maarten.lankhorst@...ux.intel.com>, 
	Maxime Ripard <mripard@...nel.org>, Thomas Zimmermann <tzimmermann@...e.de>, 
	Matthew Brost <matthew.brost@...el.com>, Danilo Krummrich <dakr@...nel.org>, 
	Philipp Stanner <phasta@...nel.org>, Alexander Viro <viro@...iv.linux.org.uk>, 
	Christian Brauner <brauner@...nel.org>, Jan Kara <jack@...e.cz>, 
	Sumit Semwal <sumit.semwal@...aro.org>, Alexander Potapenko <glider@...gle.com>, 
	Marco Elver <elver@...gle.com>, Dmitry Vyukov <dvyukov@...gle.com>, 
	"Michael S. Tsirkin" <mst@...hat.com>, Jason Wang <jasowang@...hat.com>, 
	Xuan Zhuo <xuanzhuo@...ux.alibaba.com>, Eugenio Pérez <eperezma@...hat.com>, 
	Andrew Morton <akpm@...ux-foundation.org>, Uladzislau Rezki <urezki@...il.com>, 
	Nikolay Aleksandrov <razor@...ckwall.org>, Ido Schimmel <idosch@...dia.com>, 
	"David S. Miller" <davem@...emloft.net>, Eric Dumazet <edumazet@...gle.com>, 
	Jakub Kicinski <kuba@...nel.org>, Paolo Abeni <pabeni@...hat.com>, Simon Horman <horms@...nel.org>, 
	Taimur Hassan <Syed.Hassan@....com>, Wayne Lin <Wayne.Lin@....com>, Alex Hung <alex.hung@....com>, 
	Aurabindo Pillai <aurabindo.pillai@....com>, Dillon Varone <Dillon.Varone@....com>, 
	George Shen <george.shen@....com>, Aric Cyr <aric.cyr@....com>, 
	Cruise Hung <Cruise.Hung@....com>, Mario Limonciello <mario.limonciello@....com>, 
	Sunil Khatri <sunil.khatri@....com>, Dominik Kaszewski <dominik.kaszewski@....com>, 
	David Hildenbrand <david@...nel.org>, Peter Zijlstra <peterz@...radead.org>, 
	Lorenzo Stoakes <lorenzo.stoakes@...cle.com>, Max Kellermann <max.kellermann@...os.com>, 
	"Nysal Jan K.A." <nysal@...ux.ibm.com>, Ryan Roberts <ryan.roberts@....com>, 
	Alexey Skidanov <alexey.skidanov@...el.com>, Vlastimil Babka <vbabka@...e.cz>, 
	Kent Overstreet <kent.overstreet@...ux.dev>, Vitaly Wool <vitaly.wool@...sulko.se>, 
	Harry Yoo <harry.yoo@...cle.com>, Mateusz Guzik <mjguzik@...il.com>, NeilBrown <neil@...wn.name>, 
	Amir Goldstein <amir73il@...il.com>, Jeff Layton <jlayton@...nel.org>, 
	Ivan Lipski <ivan.lipski@....com>, Tao Zhou <tao.zhou1@....com>, 
	YiPeng Chai <YiPeng.Chai@....com>, Hawking Zhang <Hawking.Zhang@....com>, 
	Lyude Paul <lyude@...hat.com>, Daniel Almeida <daniel.almeida@...labora.com>, 
	Luben Tuikov <luben.tuikov@....com>, Matthew Auld <matthew.auld@...el.com>, 
	Roopa Prabhu <roopa@...ulusnetworks.com>, Mao Zhu <zhumao001@...suo.com>, 
	Shaomin Deng <dengshaomin@...rlc.com>, Charles Han <hanchunchao@...pur.com>, 
	Jilin Yuan <yuanjilin@...rlc.com>, Swaraj Gaikwad <swarajgaikwad1925@...il.com>, 
	George Anthony Vernon <contact@...rnon.com>
Subject: Re: [Linaro-mm-sig] [PATCH 09/14] drm/amd/display: Don't use
 kernel-doc comment in dc_register_software_state struct

Applied.  Thanks!

On Mon, Dec 15, 2025 at 6:41 AM Bagas Sanjaya <bagasdotme@...il.com> wrote:
>
> Sphinx reports kernel-doc warning:
>
> WARNING: ./drivers/gpu/drm/amd/display/dc/dc.h:2796 This comment starts with '/**', but isn't a kernel-doc comment. Refer to Documentation/doc-guide/kernel-doc.rst
>  * Software state variables used to program register fields across the display pipeline
>
> Don't use kernel-doc comment syntax to fix it.
>
> Fixes: b0ff344fe70cd2 ("drm/amd/display: Add interface to capture expected HW state from SW state")
> Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>
> ---
>  drivers/gpu/drm/amd/display/dc/dc.h | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/drivers/gpu/drm/amd/display/dc/dc.h b/drivers/gpu/drm/amd/display/dc/dc.h
> index 29edfa51ea2cc0..0a9758a042586f 100644
> --- a/drivers/gpu/drm/amd/display/dc/dc.h
> +++ b/drivers/gpu/drm/amd/display/dc/dc.h
> @@ -2793,7 +2793,7 @@ void dc_get_underflow_debug_data_for_otg(struct dc *dc, int primary_otg_inst, st
>
>  void dc_get_power_feature_status(struct dc *dc, int primary_otg_inst, struct power_features *out_data);
>
> -/**
> +/*
>   * Software state variables used to program register fields across the display pipeline
>   */
>  struct dc_register_software_state {
> --
> An old man doll... just what I always wanted! - Clara
>
> _______________________________________________
> Linaro-mm-sig mailing list -- linaro-mm-sig@...ts.linaro.org
> To unsubscribe send an email to linaro-mm-sig-leave@...ts.linaro.org