linux-kernel - Re: [PATCH v2] mm: rmap.c: fix kenrel-doc warning

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: <97577076-8083-df9e-15fd-fc1a5fdaf748@redhat.com>
Date:   Fri, 6 Oct 2023 14:54:09 +0200
From:   David Hildenbrand <david@...hat.com>
To:     Muhammad Muzammil <m.muzzammilashraf@...il.com>,
        akpm@...ux-foundation.org
Cc:     linux-mm@...ck.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH v2] mm: rmap.c: fix kenrel-doc warning

On 06.10.23 14:28, Muhammad Muzammil wrote:
> after running make htmldocs, getting this warning
> warning: Function parameter or member 'folio' not described in
> 'folio_move_anon_rmap'
> and this patch resolves this warning
> 
> changes since v1:
> 	- changed page to folio and reverted other changes
> 
> Signed-off-by: Muhammad Muzammil <m.muzzammilashraf@...il.com>
> ---
>   mm/rmap.c | 2 +-
>   1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/mm/rmap.c b/mm/rmap.c
> index c1f11c9dbe61..6976fb6feeed 100644
> --- a/mm/rmap.c
> +++ b/mm/rmap.c
> @@ -1129,7 +1129,7 @@ int folio_total_mapcount(struct folio *folio)
>   
>   /**
>    * folio_move_anon_rmap - move a folio to our anon_vma
> - * @page:	The folio to move to our anon_vma
> + * @folio:  The folio to move to our anon_vma
>    * @vma:	The vma the folio belongs to
>    *
>    * When a folio belongs exclusively to one process after a COW event,

Reviewed-by: David Hildenbrand <david@...hat.com>

-- 
Cheers,

David / dhildenb