[SCSI] megaraid: fix kernel-doc

kernel-doc modifications:
- change "@param var" notation to @var;
- change function/description separator from ':' to '-';
- change var/description separator from '-' to ':';
- fix a few doc. typos;
- don't use kernel-doc /** lead-in when the doc. block is not kernel-doc;
- use Linux common */ ending comment format instead of **/;
- use correct function parameter names;
- place function parameters immediately after the function short description;
- place kernel-doc immediately before its function or macro;

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Acked-by: Sumant Patro <sumantp@lsil.com>
Signed-off-by: James Bottomley <James.Bottomley@SteelEye.com>

1 files changed, 21 insertions, 21 deletions

diff --git a/drivers/scsi/megaraid/megaraid_mbox.h b/drivers/scsi/megaraid/megaraid_mbox.h
index 963e0d2dbd97..9de803cebd4b 100644
--- a/drivers/scsi/megaraid/megaraid_mbox.h
+++ b/drivers/scsi/megaraid/megaraid_mbox.h
@@ -146,27 +146,27 @@ typedef struct {
 
 /**
  * mraid_device_t - adapter soft state structure for mailbox controllers
- * @param una_mbox64            : 64-bit mbox - unaligned
- * @param una_mbox64_dma        : mbox dma addr - unaligned
- * @param mbox                  : 32-bit mbox - aligned
- * @param mbox64                : 64-bit mbox - aligned
- * @param mbox_dma              : mbox dma addr - aligned
- * @param mailbox_lock          : exclusion lock for the mailbox
- * @param baseport              : base port of hba memory
- * @param baseaddr              : mapped addr of hba memory
- * @param mbox_pool             : pool of mailboxes
- * @param mbox_pool_handle      : handle for the mailbox pool memory
- * @param epthru_pool           : a pool for extended passthru commands
- * @param epthru_pool_handle    : handle to the pool above
- * @param sg_pool               : pool of scatter-gather lists for this driver
- * @param sg_pool_handle        : handle to the pool above
- * @param ccb_list              : list of our command control blocks
- * @param uccb_list             : list of cmd control blocks for mgmt module
- * @param umbox64               : array of mailbox for user commands (cmm)
- * @param pdrv_state            : array for state of each physical drive.
- * @param last_disp             : flag used to show device scanning
- * @param hw_error              : set if FW not responding
- * @param fast_load             : If set, skip physical device scanning
+ * @una_mbox64                  : 64-bit mbox - unaligned
+ * @una_mbox64_dma              : mbox dma addr - unaligned
+ * @mbox                        : 32-bit mbox - aligned
+ * @mbox64                      : 64-bit mbox - aligned
+ * @mbox_dma                    : mbox dma addr - aligned
+ * @mailbox_lock                : exclusion lock for the mailbox
+ * @baseport                    : base port of hba memory
+ * @baseaddr                    : mapped addr of hba memory
+ * @mbox_pool                   : pool of mailboxes
+ * @mbox_pool_handle            : handle for the mailbox pool memory
+ * @epthru_pool                 : a pool for extended passthru commands
+ * @epthru_pool_handle          : handle to the pool above
+ * @sg_pool                     : pool of scatter-gather lists for this driver
+ * @sg_pool_handle              : handle to the pool above
+ * @ccb_list                    : list of our command control blocks
+ * @uccb_list                   : list of cmd control blocks for mgmt module
+ * @umbox64                     : array of mailbox for user commands (cmm)
+ * @pdrv_state                  : array for state of each physical drive.
+ * @last_disp                   : flag used to show device scanning
+ * @hw_error                    : set if FW not responding
+ * @fast_load                   : If set, skip physical device scanning
  * @channel_class               : channel class, RAID or SCSI
  * @sysfs_sem                   : semaphore to serialize access to sysfs res.
  * @sysfs_uioc                  : management packet to issue FW calls from sysfs