[PATCH] iov_iter: fix kernel-doc comments issues

2021-04-05 Thread alexs
From: Alex Shi There are some issues of kernel-doc comments: lib/iov_iter.c:752: warning: Function parameter or member 'i' not described in '_copy_mc_to_iter' lib/iov_iter.c:752: warning: Excess function parameter 'iter' description in '_copy_mc_to_iter' lib/iov_iter.c:886: warning: Function pa

[PATCH] lib/percpu_counter: tame kernel-doc compile warning

2021-04-05 Thread alexs
From: Alex Shi commit 3e8f399da490 ("writeback: rework wb_[dec|inc]_stat family of functions") add some function description of percpu_counter_add_batch. but the double '*' in comments means a kernel-doc format comment which isn't right. Since the whole file of lib/percpu_counter.c has no any ot

[RFC PATCH] lib/genalloc: add parameter description to fix doc compile warning

2021-04-05 Thread alexs
From: Alex Shi commit 52fbf1134d47 ("lib/genalloc.c: fix allocation of aligned buffer from non-aligned chunk") add a new parameter 'start_addr' w/o description for it. That cause some doc compile warning: lib/genalloc.c:649: warning: Function parameter or member 'start_addr' not described in '