Skip to contentSkip to conversation

block_dev: fix kernel-doc in new functions

PATCH In review Randy Dunlap 2 participants 2 messages Oct 8, 2008 – Oct 9, 2008 VFS

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 block_dev: fix kernel-doc in new functions

From: Randy Dunlap <[email protected]>

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'

cc Andrew Patterson <[email protected]>
---
 fs/block_dev.c |   13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)
fs/block_dev.c +4 -9
@@ -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.
  */
#1 lore raw
Quoted 10 lines · Randy Dunlap

From: Randy Dunlap <[email protected]>

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'

cc Andrew Patterson <[email protected]>

Thanks Randy, applied.

Signature · 1 line
Jens Axboe