linux-kernel - Re: [PATCH] block: Fix non-kernel-doc comment

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: <20220302072047.GA32222@amd>
Date:   Wed, 2 Mar 2022 08:20:48 +0100
From:   Pavel Machek <pavel@....cz>
To:     Jiapeng Chong <jiapeng.chong@...ux.alibaba.com>
Cc:     rafael@...nel.org, len.brown@...el.com, linux-pm@...r.kernel.org,
        linux-kernel@...r.kernel.org, Abaci Robot <abaci@...ux.alibaba.com>
Subject: Re: [PATCH] block: Fix non-kernel-doc comment

Hi!

> Fixes the following W=1 kernel build warning:
> 
> kernel/power/swap.c:120: warning: This comment starts with '/**', but
> isn't a kernel-doc comment. Refer
> Documentation/doc-guide/kernel-doc.rst.
> +++ b/kernel/power/swap.c

> @@ -170,7 +170,7 @@ static int swsusp_extents_insert(unsigned long swap_offset)
>  	return 0;
>  }
>  
> -/**
> +/*
>   *	alloc_swapdev_block - allocate a swap page and register that it has
>   *	been allocated, so that it can be freed in case of an error.
>   */

The ones before look ok, but this and next one perhaps should be
converted to kerneldoc?

BR,
							Pavel
-- 
http://www.livejournal.com/~pavelmachek

Download attachment "signature.asc" of type "application/pgp-signature" (182 bytes)