diff mbox series

block: fix kerneldoc comment for blk_attempt_plug_merge()

Message ID 20190109135932.7578d716@lwn.net (mailing list archive)
State New, archived
Headers show
Series block: fix kerneldoc comment for blk_attempt_plug_merge() | expand

Commit Message

Jonathan Corbet Jan. 9, 2019, 8:59 p.m. UTC
Commit 5f0ed774ed29 ("block: sum requests in the plug structure") removed
the request_count parameter from block_attempt_plug_merge(), but did not
remove the associated kerneldoc comment, introducing this warning to the
docs build:

  ./block/blk-core.c:685: warning: Excess function parameter 'request_count' description in 'blk_attempt_plug_merge'

Remove the obsolete description and make things a little quieter.

Signed-off-by: Jonathan Corbet <corbet@lwn.net>
---
 block/blk-core.c | 1 -
 1 file changed, 1 deletion(-)

Comments

Jens Axboe Jan. 9, 2019, 10:29 p.m. UTC | #1
On 1/9/19 1:59 PM, Jonathan Corbet wrote:
> Commit 5f0ed774ed29 ("block: sum requests in the plug structure") removed
> the request_count parameter from block_attempt_plug_merge(), but did not
> remove the associated kerneldoc comment, introducing this warning to the
> docs build:
> 
>   ./block/blk-core.c:685: warning: Excess function parameter 'request_count' description in 'blk_attempt_plug_merge'
> 
> Remove the obsolete description and make things a little quieter.

Applied, thanks Jon.
diff mbox series

Patch

diff --git a/block/blk-core.c b/block/blk-core.c
index c78042975737..eba494f528cb 100644
--- a/block/blk-core.c
+++ b/block/blk-core.c
@@ -661,7 +661,6 @@  bool bio_attempt_discard_merge(struct request_queue *q, struct request *req,
  * blk_attempt_plug_merge - try to merge with %current's plugged list
  * @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 gets filled in when
  * another request associated with @q is found on the plug list
  * (optional, may be %NULL)