[PATCH] block: fix blk-core.c kernel-doc warning

[PATCH] block: fix blk-core.c kernel-doc warning

[Randy Dunlap]

From: Randy Dunlap <rdunlap@infradead.org>

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

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

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
 block/blk-core.c |    2 ++
 1 file changed, 2 insertions(+)

--- lnx-42-rc6.orig/block/blk-core.c
+++ lnx-42-rc6/block/blk-core.c
@@ -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,

Re: [PATCH] block: fix blk-core.c kernel-doc warning

[Jeff Moyer]

Randy Dunlap <rdunlap@infradead.org> writes:

> From: Randy Dunlap <rdunlap@infradead.org>
>
> Fix kernel-doc warning in blk-core.c:
>
> Warning(..//block/blk-core.c:1545): No description found for parameter 'same_queue_rq'
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> ---
>  block/blk-core.c |    2 ++
>  1 file changed, 2 insertions(+)
>
> --- lnx-42-rc6.orig/block/blk-core.c
> +++ lnx-42-rc6/block/blk-core.c
> @@ -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