linux-kernel - Re: [PATCH] Removed redundant @ symbol to fix kernel-doc warnings in -next repo

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]

Date: Wed, 6 Mar 2024 13:07:09 -0500
From: Alex Deucher <alexdeucher@...il.com>
To: R SUNDAR <prosunofficial@...il.com>
Cc: harry.wentland@....com, sunpeng.li@....com, Rodrigo.Siqueira@....com, 
	alexander.deucher@....com, christian.koenig@....com, Xinhui.Pan@....com, 
	airlied@...il.com, daniel@...ll.ch, rdunlap@...radead.org, 
	mario.limonciello@....com, mwen@...lia.com, swarupkotikalapudi@...il.com, 
	amd-gfx@...ts.freedesktop.org, dri-devel@...ts.freedesktop.org, 
	linux-kernel@...r.kernel.org
Subject: Re: [PATCH] Removed redundant @ symbol to fix kernel-doc warnings in
 -next repo

Fixed up patch title prefix and applied.

Thanks!

Alex

On Tue, Mar 5, 2024 at 10:48 PM R SUNDAR <prosunofficial@...il.com> wrote:
>
> For linux-next repository.
>
> ./drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h:1: warning: no structured comments found
> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:132: warning: Incorrect use of kernel-doc format:          * @@overlap_only: Whether overlapping of different planes is allowed.
> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:132: warning: Incorrect use of kernel-doc format:          * @@overlap_only: Whether overlapping of different planes is allowed.
> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:1: warning: no structured comments found
> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:132: warning: Incorrect use of kernel-doc format:          * @@overlap_only: Whether overlapping of different planes is allowed.
> ./drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h:162: warning: Function parameter or struct member 'pre_multiplied_alpha' not described in 'mpcc_blnd_cfg'
>
> Signed-off-by: R SUNDAR <prosunofficial@...il.com>
> ---
>  drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h | 7 +++----
>  1 file changed, 3 insertions(+), 4 deletions(-)
>
> diff --git a/drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h b/drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h
> index ba9b942ce09f..34a398f23fc6 100644
> --- a/drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h
> +++ b/drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h
> @@ -110,9 +110,8 @@ struct mpcc_blnd_cfg {
>          */
>         enum mpcc_alpha_blend_mode alpha_mode;
>
> -       /***
> -        * @@pre_multiplied_alpha:
> -        *
> +       /**
> +        * @pre_multiplied_alpha:
>          * Whether pixel color values were pre-multiplied by the alpha channel
>          * (MPCC_ALPHA_MULTIPLIED_MODE).
>          */
> @@ -129,7 +128,7 @@ struct mpcc_blnd_cfg {
>         int global_alpha;
>
>         /**
> -        * @@overlap_only: Whether overlapping of different planes is allowed.
> +        * @overlap_only: Whether overlapping of different planes is allowed.
>          */
>         bool overlap_only;
>
> --
> 2.34.1
>