[PATCH] mm/workingset: correct kernel-doc notations

[PATCH] mm/workingset: correct kernel-doc notations

[Randy Dunlap]

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@infradead.org>
Cc: Matthew Wilcox (Oracle) <willy@infradead.org>
Cc: Andrew Morton <akpm@linux-foundation.org>
---
 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