linux-kernel - Re: (subset) [PATCH] drm/gpuvm: fix all kernel-doc warnings in include/drm/drm

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: <170419691176.40444.10974951335864168789.b4-ty@kernel.org>
Date: Tue, 02 Jan 2024 13:01:51 +0100
From: Maxime Ripard <mripard@...nel.org>
To: linux-kernel@...r.kernel.org, Randy Dunlap <rdunlap@...radead.org>
Cc: Maarten Lankhorst <maarten.lankhorst@...ux.intel.com>, 
 Thomas Zimmermann <tzimmermann@...e.de>, David Airlie <airlied@...il.com>, 
 Daniel Vetter <daniel@...ll.ch>, dri-devel@...ts.freedesktop.org, 
 Jonathan Corbet <corbet@....net>, Vegard Nossum <vegard.nossum@...cle.com>
Subject: Re: (subset) [PATCH] drm/gpuvm: fix all kernel-doc warnings in
 include/drm/drm_gpuvm.h

On Sat, 30 Dec 2023 21:48:56 -0800, Randy Dunlap wrote:
> Update kernel-doc comments in <drm/drm_gpuvm.h> to correct all
> kernel-doc warnings:
> 
> drm_gpuvm.h:148: warning: Excess struct member 'addr' description in 'drm_gpuva'
> drm_gpuvm.h:148: warning: Excess struct member 'offset' description in 'drm_gpuva'
> drm_gpuvm.h:148: warning: Excess struct member 'obj' description in 'drm_gpuva'
> drm_gpuvm.h:148: warning: Excess struct member 'entry' description in 'drm_gpuva'
> drm_gpuvm.h:148: warning: Excess struct member '__subtree_last' description in 'drm_gpuva'
> drm_gpuvm.h:192: warning: No description found for return value of 'drm_gpuva_invalidated'
> drm_gpuvm.h:331: warning: Excess struct member 'tree' description in 'drm_gpuvm'
> drm_gpuvm.h:331: warning: Excess struct member 'list' description in 'drm_gpuvm'
> drm_gpuvm.h:331: warning: Excess struct member 'list' description in 'drm_gpuvm'
> drm_gpuvm.h:331: warning: Excess struct member 'local_list' description in 'drm_gpuvm'
> drm_gpuvm.h:331: warning: Excess struct member 'lock' description in 'drm_gpuvm'
> drm_gpuvm.h:331: warning: Excess struct member 'list' description in 'drm_gpuvm'
> drm_gpuvm.h:331: warning: Excess struct member 'local_list' description in 'drm_gpuvm'
> drm_gpuvm.h:331: warning: Excess struct member 'lock' description in 'drm_gpuvm'
> drm_gpuvm.h:352: warning: No description found for return value of 'drm_gpuvm_get'
> drm_gpuvm.h:545: warning: Excess struct member 'fn' description in 'drm_gpuvm_exec'
> drm_gpuvm.h:545: warning: Excess struct member 'priv' description in 'drm_gpuvm_exec'
> drm_gpuvm.h:597: warning: missing initial short description on line:
>  * drm_gpuvm_exec_resv_add_fence()
> drm_gpuvm.h:616: warning: missing initial short description on line:
>  * drm_gpuvm_exec_validate()
> drm_gpuvm.h:623: warning: No description found for return value of 'drm_gpuvm_exec_validate'
> drm_gpuvm.h:698: warning: Excess struct member 'gpuva' description in 'drm_gpuvm_bo'
> drm_gpuvm.h:698: warning: Excess struct member 'entry' description in 'drm_gpuvm_bo'
> drm_gpuvm.h:698: warning: Excess struct member 'gem' description in 'drm_gpuvm_bo'
> drm_gpuvm.h:698: warning: Excess struct member 'evict' description in 'drm_gpuvm_bo'
> drm_gpuvm.h:726: warning: No description found for return value of 'drm_gpuvm_bo_get'
> drm_gpuvm.h:738: warning: missing initial short description on line:
>  * drm_gpuvm_bo_gem_evict()
> drm_gpuvm.h:740: warning: missing initial short description on line:
>  * drm_gpuvm_bo_gem_evict()
> drm_gpuvm.h:698: warning: Excess struct member 'evict' description in 'drm_gpuvm_bo'
> drm_gpuvm.h:844: warning: Excess struct member 'addr' description in 'drm_gpuva_op_map'
> drm_gpuvm.h:844: warning: Excess struct member 'range' description in 'drm_gpuva_op_map'
> drm_gpuvm.h:844: warning: Excess struct member 'offset' description in 'drm_gpuva_op_map'
> drm_gpuvm.h:844: warning: Excess struct member 'obj' description in 'drm_gpuva_op_map'
> 
> [...]

Applied to drm/drm-misc (drm-misc-next-fixes).

Thanks!
Maxime