Skip to contentSkip to conversation

block: Add parameter description in kernel-doc comment

PATCH New Yang Li 1 participant 1 message Mar 16, 2022

Subsystems (4)
lore
Share & tools
lore

Yang Li

author
#0 lore raw

PATCH 1/1 block: Add parameter description in kernel-doc comment

Add the description of @ioprio_class in bfq_reparent_leaf_entity() and bfq_reparent_active_queues() kernel-doc comment to remove warning found by running scripts/kernel-doc, which is caused by using 'make W=1'.

block/bfq-cgroup.c:848: warning: Function parameter or member 'ioprio_class' not described in 'bfq_reparent_leaf_entity' block/bfq-cgroup.c:878: warning: Function parameter or member 'ioprio_class' not described in 'bfq_reparent_active_queues'

---
 block/bfq-cgroup.c | 2 ++
 1 file changed, 2 insertions(+)
block/bfq-cgroup.c +2 -0
index 420eda2589c0..af92c2e5fd98 100644
@@ -841,6 +841,7 @@ static void bfq_flush_idle_tree(struct bfq_service_tree *st)
  * @bfqd: the device data structure with the root group.
  * @entity: the entity to move, if entity is a leaf; or the parent entity
  *	    of an active leaf entity to move, if entity is not a leaf.
+ * @ioprio_class: the offset used to manipulate the service_tree
  */
 static void bfq_reparent_leaf_entity(struct bfq_data *bfqd,
 				     struct bfq_entity *entity,
@@ -870,6 +871,7 @@ static void bfq_reparent_leaf_entity(struct bfq_data *bfqd,
  * @bfqd: the device data structure with the root group.
  * @bfqg: the group to move from.
  * @st: the service tree to start the search from.
+ * @ioprio_class: the offset used to manipulate the service_tree
  */
 static void bfq_reparent_active_queues(struct bfq_data *bfqd,
 				       struct bfq_group *bfqg,
Signature · 1 line
2.20.1.7.g153144c