Skip to contentSkip to conversation

mm/mlock: Fix argument list that the kdoc format and script verified.

PATCH In review Yang Li 2 participants 2 messages Feb 24, 2022

Subsystems (2)
lore
Share & tools
lore

Yang Li

author
#0 lore raw

PATCH 1/1 mm/mlock: Fix argument list that the kdoc format and script verified.

The warnings were found by running scripts/kernel-doc, which is caused by using 'make W=1'.

mm/mlock.c:225: warning: Function parameter or member 'folio' not described in 'mlock_folio'
mm/mlock.c:225: warning: Excess function parameter 'page' description in 'mlock_folio'

---
 mm/mlock.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
mm/mlock.c +1 -1
index e8e4274480bf..d6294042698a 100644
@@ -219,7 +219,7 @@ bool need_mlock_page_drain(int cpu)
 
 /**
  * mlock_folio - mlock a folio already on (or temporarily off) LRU
- * @page: folio to be mlocked.
+ * @folio: The folio we're currently operating on.
  */
 void mlock_folio(struct folio *folio)
 {
Signature · 1 line
2.20.1.7.g153144c
#1 lore raw
Quoted 7 lines · Yang Li

The warnings were found by running scripts/kernel-doc, which is caused by using 'make W=1'.

mm/mlock.c:225: warning: Function parameter or member 'folio' not described in 'mlock_folio'
mm/mlock.c:225: warning: Excess function parameter 'page' description in 'mlock_folio'

Folded it into the patch that introduced the problem.