Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

block: fix current kernel-doc warnings

Fix block kernel-doc warnings:

Warning(linux-2.6.27-git4//fs/block_dev.c:1272): No description found for parameter 'path'
Warning(linux-2.6.27-git4//block/blk-core.c:1021): No description found for parameter 'cpu'
Warning(linux-2.6.27-git4//block/blk-core.c:1021): No description found for parameter 'part'
Warning(/var/linsrc/linux-2.6.27-git4//block/genhd.c:544): No description found for parameter 'partno'

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Jens Axboe <jens.axboe@oracle.com>

authored by

Randy Dunlap and committed by
Jens Axboe
496aa8a9 80a4b58e

+5 -4
+3 -2
block/blk-core.c
··· 1018 1018 } 1019 1019 1020 1020 /** 1021 - * part_round_stats() - Round off the performance stats on a struct 1022 - * disk_stats. 1021 + * part_round_stats() - Round off the performance stats on a struct disk_stats. 1022 + * @cpu: cpu number for stats access 1023 + * @part: target partition 1023 1024 * 1024 1025 * The average IO queue length and utilisation statistics are maintained 1025 1026 * by observing the current state of the queue length and the amount of
+1 -1
block/genhd.c
··· 534 534 /** 535 535 * get_gendisk - get partitioning information for a given device 536 536 * @devt: device to get partitioning information for 537 - * @part: returned partition index 537 + * @partno: returned partition index 538 538 * 539 539 * This function gets the structure containing partitioning 540 540 * information for the given device @devt.
+1 -1
fs/block_dev.c
··· 1262 1262 1263 1263 /** 1264 1264 * lookup_bdev - lookup a struct block_device by name 1265 - * @pathname: special file representing the block device 1265 + * @path: special file representing the block device 1266 1266 * 1267 1267 * Get a reference to the blockdevice at @pathname in the current 1268 1268 * namespace if possible and return it. Return ERR_PTR(error)