blk-cgroup: Fix some kernel-doc comments

Yang Li · axboe · commit 1d6df9d352bb · 2022-12-01T18:22:12.000-07:00
Make the description of @gendisk to @disk in blkcg_schedule_throttle() to clear the below warnings: block/blk-cgroup.c:1850: warning: Function parameter or member 'disk' not described in 'blkcg_schedule_throttle' block/blk-cgroup.c:1850: warning: Excess function parameter 'gendisk' description in 'blkcg_schedule_throttle' Fixes: de185b5 ("blk-cgroup: pass a gendisk to blkcg_schedule_throttle") Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=3338 Reported-by: Abaci Robot <abaci@linux.alibaba.com> Signed-off-by: Yang Li <yang.lee@linux.alibaba.com> Link: https://lore.kernel.org/r/20221202011713.14834-1-yang.lee@linux.alibaba.com Signed-off-by: Jens Axboe <axboe@kernel.dk>
diff --git a/block/blk-cgroup.c b/block/blk-cgroup.c
@@ -1831,7 +1831,7 @@ void blkcg_maybe_throttle_current(void)
 
 /**
  * blkcg_schedule_throttle - this task needs to check for throttling
- * @gendisk: disk to throttle
+ * @disk: disk to throttle
  * @use_memdelay: do we charge this to memory delay for PSI
  *
  * This is called by the IO controller when we know there's delay accumulated

Original file line number	Diff line number	Diff line change
`@@ -1831,7 +1831,7 @@ void blkcg_maybe_throttle_current(void)`
`1831`	`1831`
`1832`	`1832`	`/**`
`1833`	`1833`	`* blkcg_schedule_throttle - this task needs to check for throttling`
`1834`		`- * @gendisk: disk to throttle`
	`1834`	`+ * @disk: disk to throttle`
`1835`	`1835`	`* @use_memdelay: do we charge this to memory delay for PSI`
`1836`	`1836`	`*`
`1837`	`1837`	`* This is called by the IO controller when we know there's delay accumulated`