Use the documented kernel-doc format to prevent kernel-doc warnings. mm/workingset.c:256: warning: No description found for return value of 'workingset_eviction' mm/workingset.c:285: warning: Function parameter or member 'folio' not described in 'workingset_refault' mm/workingset.c:285: warning: Excess function parameter 'page' description in 'workingset_refault' Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx> Cc: Matthew Wilcox (Oracle) <willy@xxxxxxxxxxxxx> Cc: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx> --- mm/workingset.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) --- linux-next-20210806.orig/mm/workingset.c +++ linux-next-20210806/mm/workingset.c @@ -249,7 +249,7 @@ void workingset_age_nonresident(struct l * @target_memcg: the cgroup that is causing the reclaim * @page: the page being evicted * - * Returns a shadow entry to be stored in @page->mapping->i_pages in place + * Return: a shadow entry to be stored in @page->mapping->i_pages in place * of the evicted @page so that a later refault can be detected. */ void *workingset_eviction(struct page *page, struct mem_cgroup *target_memcg) @@ -274,7 +274,7 @@ void *workingset_eviction(struct page *p /** * workingset_refault - evaluate the refault of a previously evicted folio - * @page: the freshly allocated replacement folio + * @folio: the freshly allocated replacement folio * @shadow: shadow entry of the evicted folio * * Calculates and evaluates the refault distance of the previously
