From: Randy Dunlap <randy.dunlap@oracle.com>
To: lkml <linux-kernel@vger.kernel.org>, jens.axboe@oracle.com
Subject: [PATCH] block: fix current kernel-doc warnings
Date: Tue, 14 Oct 2008 10:04:00 -0700 [thread overview]
Message-ID: <48F4D100.5080400@oracle.com> (raw)
From: Randy Dunlap <randy.dunlap@oracle.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@oracle.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)
next reply other threads:[~2008-10-14 17:04 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-10-14 17:04 Randy Dunlap [this message]
2008-10-16 5:46 ` [PATCH] block: fix current kernel-doc warnings Jens Axboe
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=48F4D100.5080400@oracle.com \
--to=randy.dunlap@oracle.com \
--cc=jens.axboe@oracle.com \
--cc=linux-kernel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.