OSDN Git Service

block: remove typo in kernel-doc of set_disk_ro()
authorLukas Bulwahn <lukas.bulwahn@gmail.com>
Fri, 29 Jan 2021 04:55:05 +0000 (05:55 +0100)
committerJens Axboe <axboe@kernel.dk>
Fri, 29 Jan 2021 14:15:50 +0000 (07:15 -0700)
Commit 52f019d43c22 ("block: add a hard-readonly flag to struct gendisk")
provides some kernel-doc for set_disk_ro(), but introduces a small typo.

Hence, make htmldocs warns on ./block/genhd.c:1441:

  warning: Function parameter or member 'read_only' not described in 'set_disk_ro'
  warning: Excess function parameter 'ready_only' description in 'set_disk_ro'

Remove that typo in the kernel-doc for set_disk_ro().

Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Jens Axboe <axboe@kernel.dk>
block/genhd.c

index d3ef29f..304f8dc 100644 (file)
@@ -1431,7 +1431,7 @@ static void set_disk_ro_uevent(struct gendisk *gd, int ro)
 /**
  * set_disk_ro - set a gendisk read-only
  * @disk:      gendisk to operate on
- * @ready_only:        %true to set the disk read-only, %false set the disk read/write
+ * @read_only: %true to set the disk read-only, %false set the disk read/write
  *
  * This function is used to indicate whether a given disk device should have its
  * read-only flag set. set_disk_ro() is typically used by device drivers to