diff options
author | Randy Dunlap <randy.dunlap@oracle.com> | 2006-12-06 23:38:43 -0500 |
---|---|---|
committer | Linus Torvalds <torvalds@woody.osdl.org> | 2006-12-07 11:39:40 -0500 |
commit | d9489fb60614794cbca4b6b173c60ed9388974c6 (patch) | |
tree | fce67aa376841050cec0007f2a47b568286c025a /drivers/message/i2o/i2o_block.c | |
parent | da39aa8fbc031029b1f06f1abf2a933e1042fe99 (diff) |
[PATCH] kernel-doc: fix fusion and i2o docs
Correct lots of typos, kernel-doc warnings, & kernel-doc usage in fusion and
i2o drivers.
Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
Diffstat (limited to 'drivers/message/i2o/i2o_block.c')
-rw-r--r-- | drivers/message/i2o/i2o_block.c | 15 |
1 files changed, 11 insertions, 4 deletions
diff --git a/drivers/message/i2o/i2o_block.c b/drivers/message/i2o/i2o_block.c index 70ae00253321..da9859f2caf2 100644 --- a/drivers/message/i2o/i2o_block.c +++ b/drivers/message/i2o/i2o_block.c | |||
@@ -259,7 +259,7 @@ static int i2o_block_device_unlock(struct i2o_device *dev, u32 media_id) | |||
259 | /** | 259 | /** |
260 | * i2o_block_device_power - Power management for device dev | 260 | * i2o_block_device_power - Power management for device dev |
261 | * @dev: I2O device which should receive the power management request | 261 | * @dev: I2O device which should receive the power management request |
262 | * @operation: Operation which should be send | 262 | * @op: Operation to send |
263 | * | 263 | * |
264 | * Send a power management request to the device dev. | 264 | * Send a power management request to the device dev. |
265 | * | 265 | * |
@@ -315,7 +315,7 @@ static inline struct i2o_block_request *i2o_block_request_alloc(void) | |||
315 | * i2o_block_request_free - Frees a I2O block request | 315 | * i2o_block_request_free - Frees a I2O block request |
316 | * @ireq: I2O block request which should be freed | 316 | * @ireq: I2O block request which should be freed |
317 | * | 317 | * |
318 | * Fres the allocated memory (give it back to the request mempool). | 318 | * Frees the allocated memory (give it back to the request mempool). |
319 | */ | 319 | */ |
320 | static inline void i2o_block_request_free(struct i2o_block_request *ireq) | 320 | static inline void i2o_block_request_free(struct i2o_block_request *ireq) |
321 | { | 321 | { |
@@ -326,6 +326,7 @@ static inline void i2o_block_request_free(struct i2o_block_request *ireq) | |||
326 | * i2o_block_sglist_alloc - Allocate the SG list and map it | 326 | * i2o_block_sglist_alloc - Allocate the SG list and map it |
327 | * @c: I2O controller to which the request belongs | 327 | * @c: I2O controller to which the request belongs |
328 | * @ireq: I2O block request | 328 | * @ireq: I2O block request |
329 | * @mptr: message body pointer | ||
329 | * | 330 | * |
330 | * Builds the SG list and map it to be accessable by the controller. | 331 | * Builds the SG list and map it to be accessable by the controller. |
331 | * | 332 | * |
@@ -490,7 +491,7 @@ static void i2o_block_end_request(struct request *req, int uptodate, | |||
490 | * i2o_block_reply - Block OSM reply handler. | 491 | * i2o_block_reply - Block OSM reply handler. |
491 | * @c: I2O controller from which the message arrives | 492 | * @c: I2O controller from which the message arrives |
492 | * @m: message id of reply | 493 | * @m: message id of reply |
493 | * qmsg: the actuall I2O message reply | 494 | * @msg: the actual I2O message reply |
494 | * | 495 | * |
495 | * This function gets all the message replies. | 496 | * This function gets all the message replies. |
496 | * | 497 | * |
@@ -602,6 +603,8 @@ static void i2o_block_biosparam(unsigned long capacity, unsigned short *cyls, | |||
602 | 603 | ||
603 | /** | 604 | /** |
604 | * i2o_block_open - Open the block device | 605 | * i2o_block_open - Open the block device |
606 | * @inode: inode for block device being opened | ||
607 | * @file: file to open | ||
605 | * | 608 | * |
606 | * Power up the device, mount and lock the media. This function is called, | 609 | * Power up the device, mount and lock the media. This function is called, |
607 | * if the block device is opened for access. | 610 | * if the block device is opened for access. |
@@ -629,6 +632,8 @@ static int i2o_block_open(struct inode *inode, struct file *file) | |||
629 | 632 | ||
630 | /** | 633 | /** |
631 | * i2o_block_release - Release the I2O block device | 634 | * i2o_block_release - Release the I2O block device |
635 | * @inode: inode for block device being released | ||
636 | * @file: file to close | ||
632 | * | 637 | * |
633 | * Unlock and unmount the media, and power down the device. Gets called if | 638 | * Unlock and unmount the media, and power down the device. Gets called if |
634 | * the block device is closed. | 639 | * the block device is closed. |
@@ -675,6 +680,8 @@ static int i2o_block_getgeo(struct block_device *bdev, struct hd_geometry *geo) | |||
675 | 680 | ||
676 | /** | 681 | /** |
677 | * i2o_block_ioctl - Issue device specific ioctl calls. | 682 | * i2o_block_ioctl - Issue device specific ioctl calls. |
683 | * @inode: inode for block device ioctl | ||
684 | * @file: file for ioctl | ||
678 | * @cmd: ioctl command | 685 | * @cmd: ioctl command |
679 | * @arg: arg | 686 | * @arg: arg |
680 | * | 687 | * |
@@ -902,7 +909,7 @@ static int i2o_block_transfer(struct request *req) | |||
902 | 909 | ||
903 | /** | 910 | /** |
904 | * i2o_block_request_fn - request queue handling function | 911 | * i2o_block_request_fn - request queue handling function |
905 | * q: request queue from which the request could be fetched | 912 | * @q: request queue from which the request could be fetched |
906 | * | 913 | * |
907 | * Takes the next request from the queue, transfers it and if no error | 914 | * Takes the next request from the queue, transfers it and if no error |
908 | * occurs dequeue it from the queue. On arrival of the reply the message | 915 | * occurs dequeue it from the queue. On arrival of the reply the message |