diff mbox series

mm/workingset: correct kernel-doc notations

Message ID 20210808203153.10678-1-rdunlap@infradead.org (mailing list archive)
State New
Headers show
Series mm/workingset: correct kernel-doc notations | expand

Commit Message

Randy Dunlap Aug. 8, 2021, 8:31 p.m. UTC
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(-)
diff mbox series


--- 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