[<prev] [next>] [thread-next>] [day] [month] [year] [list]
Message-ID: <48F4D100.5080400@oracle.com>
Date: Tue, 14 Oct 2008 10:04:00 -0700
From: Randy Dunlap <randy.dunlap@...cle.com>
To: lkml <linux-kernel@...r.kernel.org>, jens.axboe@...cle.com
Subject: [PATCH] block: fix current kernel-doc warnings
From: Randy Dunlap <randy.dunlap@...cle.com>
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@...cle.com>
---
block/blk-core.c | 5 +++--
block/genhd.c | 2 +-
fs/block_dev.c | 2 +-
3 files changed, 5 insertions(+), 4 deletions(-)
--- linux-2.6.27-git4.orig/block/blk-core.c
+++ linux-2.6.27-git4/block/blk-core.c
@@ -1003,8 +1003,9 @@ static void part_round_stats_single(int
}
/**
- * part_round_stats() - Round off the performance stats on a struct
- * disk_stats.
+ * part_round_stats() - Round off the performance stats on a struct disk_stats.
+ * @cpu: cpu number for stats access
+ * @part: target partition
*
* The average IO queue length and utilisation statistics are maintained
* by observing the current state of the queue length and the amount of
--- linux-2.6.27-git4.orig/block/genhd.c
+++ linux-2.6.27-git4/block/genhd.c
@@ -535,7 +535,7 @@ void unlink_gendisk(struct gendisk *disk
/**
* get_gendisk - get partitioning information for a given device
* @devt: device to get partitioning information for
- * @part: returned partition index
+ * @partno: returned partition index
*
* This function gets the structure containing partitioning
* information for the given device @devt.
--- linux-2.6.27-git4.orig/fs/block_dev.c
+++ linux-2.6.27-git4/fs/block_dev.c
@@ -1262,7 +1262,7 @@ EXPORT_SYMBOL(ioctl_by_bdev);
/**
* lookup_bdev - lookup a struct block_device by name
- * @pathname: special file representing the block device
+ * @path: special file representing the block device
*
* Get a reference to the blockdevice at @pathname in the current
* namespace if possible and return it. Return ERR_PTR(error)
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
Powered by blists - more mailing lists