[PATCH -mm/git] block_dev: fix kernel-doc in new functions

[PATCH -mm/git] block_dev: fix kernel-doc in new functions

[Randy Dunlap]

From: Randy Dunlap <randy.dunlap@oracle.com>

Fix kernel-doc in new functions:

Error(mmotm-2008-1002-1617//fs/block_dev.c:895): duplicate section name 'Description'
Error(mmotm-2008-1002-1617//fs/block_dev.c:924): duplicate section name 'Description'
Warning(mmotm-2008-1002-1617//fs/block_dev.c:1282): No description found for parameter 'pathname'

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
cc: Andrew Patterson <andrew.patterson@hp.com>

---
 fs/block_dev.c |   13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

--- mmotm-2008-1002-1617.orig/fs/block_dev.c
+++ mmotm-2008-1002-1617/fs/block_dev.c
@@ -884,9 +884,7 @@ static void flush_disk(struct block_devi
 }
 
 /**
- * check_disk_size_change - checks for disk size change and adjusts
- *                          bdev size.
- *
+ * check_disk_size_change - checks for disk size change and adjusts bdev size.
  * @disk: struct gendisk to check
  * @bdev: struct bdev to adjust.
  *
@@ -913,9 +911,7 @@ void check_disk_size_change(struct gendi
 EXPORT_SYMBOL(check_disk_size_change);
 
 /**
- * revalidate_disk - wrapper for lower-level driver's revalidate_disk
- *                   call-back
- *
+ * revalidate_disk - wrapper for lower-level driver's revalidate_disk call-back
  * @disk: struct gendisk to be revalidated
  *
  * This routine is a wrapper for lower-level driver's revalidate_disk
@@ -1271,10 +1267,9 @@ 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 @path in the current
+ * Get a reference to the blockdevice at @pathname in the current
  * namespace if possible and return it.  Return ERR_PTR(error)
  * otherwise.
  */

Re: [PATCH -mm/git] block_dev: fix kernel-doc in new functions

[Jens Axboe]

On Wed, Oct 08 2008, Randy Dunlap wrote:
> From: Randy Dunlap <randy.dunlap@oracle.com>
> 
> Fix kernel-doc in new functions:
> 
> Error(mmotm-2008-1002-1617//fs/block_dev.c:895): duplicate section name 'Description'
> Error(mmotm-2008-1002-1617//fs/block_dev.c:924): duplicate section name 'Description'
> Warning(mmotm-2008-1002-1617//fs/block_dev.c:1282): No description found for parameter 'pathname'
> 
> Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
> cc: Andrew Patterson <andrew.patterson@hp.com>

Thanks Randy, applied.

-- 
Jens Axboe