Skip to contentSkip to conversation

block: fix blk-core.c kernel-doc warning

PATCH In review Randy Dunlap 2 participants 2 messages Aug 10, 2015 – Oct 15, 2015 Block layer

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 block: fix blk-core.c kernel-doc warning

From: Randy Dunlap <[email protected]>

Fix kernel-doc warning in blk-core.c:

Warning(..//block/blk-core.c:1545): No description found for parameter 'same_queue_rq'

---
 block/blk-core.c |    2 ++
 1 file changed, 2 insertions(+)
block/blk-core.c +2 -0
@@ -1525,6 +1525,8 @@ bool bio_attempt_front_merge(struct requ
  * @q: request_queue new bio is being queued at
  * @bio: new bio being queued
  * @request_count: out parameter for number of traversed plugged requests
+ * @same_queue_rq: pointer to &struct request that may be updated if same
+ * queue is found (optional, may be %NULL)
  *
  * Determine whether @bio being queued on @q can be merged with a request
  * on %current's plugged list.  Returns %true if merge was successful,
#1 lore raw
Quoted 14 lines · Randy Dunlap

From: Randy Dunlap <[email protected]>

Fix kernel-doc warning in blk-core.c:

Warning(..//block/blk-core.c:1545): No description found for parameter 'same_queue_rq'

---
 block/blk-core.c |    2 ++
 1 file changed, 2 insertions(+)

block/blk-core.c bool bio_attempt_front_merge(struct requ · line 1529

Quoted 5 lines
block/blk-core.c +2 -0
@@ -1525,6 +1525,8 @@ bool bio_attempt_front_merge(struct requ
  * @q: request_queue new bio is being queued at
  * @bio: new bio being queued
  * @request_count: out parameter for number of traversed plugged requests
+ * @same_queue_rq: pointer to &struct request that may be updated if same
+ * queue is found (optional, may be %NULL)

pointer to &struct request that gets filled in when another request associated with @q is found on the plug list (optional, may be %NULL).

Cheers,
Jeff