docbook: fix fusion source files

Fix docbook problems in fusion source files.
These cause the generated docbook to be incorrect.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
This commit is contained in:
Randy Dunlap 2008-02-29 22:03:27 -08:00 committed by Linus Torvalds
parent 0643245f59
commit 7105a387a8
2 changed files with 18 additions and 21 deletions

View File

@ -632,8 +632,7 @@ mpt_deregister(u8 cb_idx)
/*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/ /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
/** /**
* mpt_event_register - Register protocol-specific event callback * mpt_event_register - Register protocol-specific event callback handler.
* handler.
* @cb_idx: previously registered (via mpt_register) callback handle * @cb_idx: previously registered (via mpt_register) callback handle
* @ev_cbfunc: callback function * @ev_cbfunc: callback function
* *
@ -654,8 +653,7 @@ mpt_event_register(u8 cb_idx, MPT_EVHANDLER ev_cbfunc)
/*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/ /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
/** /**
* mpt_event_deregister - Deregister protocol-specific event callback * mpt_event_deregister - Deregister protocol-specific event callback handler
* handler.
* @cb_idx: previously registered callback handle * @cb_idx: previously registered callback handle
* *
* Each protocol-specific driver should call this routine * Each protocol-specific driver should call this routine
@ -765,11 +763,13 @@ mpt_device_driver_deregister(u8 cb_idx)
/*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/ /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
/** /**
* mpt_get_msg_frame - Obtain a MPT request frame from the pool (of 1024) * mpt_get_msg_frame - Obtain an MPT request frame from the pool
* allocated per MPT adapter.
* @cb_idx: Handle of registered MPT protocol driver * @cb_idx: Handle of registered MPT protocol driver
* @ioc: Pointer to MPT adapter structure * @ioc: Pointer to MPT adapter structure
* *
* Obtain an MPT request frame from the pool (of 1024) that are
* allocated per MPT adapter.
*
* Returns pointer to a MPT request frame or %NULL if none are available * Returns pointer to a MPT request frame or %NULL if none are available
* or IOC is not active. * or IOC is not active.
*/ */
@ -834,13 +834,12 @@ mpt_get_msg_frame(u8 cb_idx, MPT_ADAPTER *ioc)
/*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/ /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
/** /**
* mpt_put_msg_frame - Send a protocol specific MPT request frame * mpt_put_msg_frame - Send a protocol-specific MPT request frame to an IOC
* to a IOC.
* @cb_idx: Handle of registered MPT protocol driver * @cb_idx: Handle of registered MPT protocol driver
* @ioc: Pointer to MPT adapter structure * @ioc: Pointer to MPT adapter structure
* @mf: Pointer to MPT request frame * @mf: Pointer to MPT request frame
* *
* This routine posts a MPT request frame to the request post FIFO of a * This routine posts an MPT request frame to the request post FIFO of a
* specific MPT adapter. * specific MPT adapter.
*/ */
void void
@ -868,13 +867,15 @@ mpt_put_msg_frame(u8 cb_idx, MPT_ADAPTER *ioc, MPT_FRAME_HDR *mf)
} }
/** /**
* mpt_put_msg_frame_hi_pri - Send a protocol specific MPT request frame * mpt_put_msg_frame_hi_pri - Send a hi-pri protocol-specific MPT request frame
* to a IOC using hi priority request queue.
* @cb_idx: Handle of registered MPT protocol driver * @cb_idx: Handle of registered MPT protocol driver
* @ioc: Pointer to MPT adapter structure * @ioc: Pointer to MPT adapter structure
* @mf: Pointer to MPT request frame * @mf: Pointer to MPT request frame
* *
* This routine posts a MPT request frame to the request post FIFO of a * Send a protocol-specific MPT request frame to an IOC using
* hi-priority request queue.
*
* This routine posts an MPT request frame to the request post FIFO of a
* specific MPT adapter. * specific MPT adapter.
**/ **/
void void

View File

@ -1533,7 +1533,7 @@ mptscsih_freeChainBuffers(MPT_ADAPTER *ioc, int req_idx)
* *
* Remark: Currently invoked from a non-interrupt thread (_bh). * Remark: Currently invoked from a non-interrupt thread (_bh).
* *
* Remark: With old EH code, at most 1 SCSI TaskMgmt function per IOC * Note: With old EH code, at most 1 SCSI TaskMgmt function per IOC
* will be active. * will be active.
* *
* Returns 0 for SUCCESS, or %FAILED. * Returns 0 for SUCCESS, or %FAILED.
@ -2537,14 +2537,12 @@ mptscsih_copy_sense_data(struct scsi_cmnd *sc, MPT_SCSI_HOST *hd, MPT_FRAME_HDR
/** /**
* mptscsih_get_scsi_lookup * mptscsih_get_scsi_lookup
*
* retrieves scmd entry from ScsiLookup[] array list
*
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @i: index into the array * @i: index into the array
* *
* Returns the scsi_cmd pointer * retrieves scmd entry from ScsiLookup[] array list
* *
* Returns the scsi_cmd pointer
**/ **/
static struct scsi_cmnd * static struct scsi_cmnd *
mptscsih_get_scsi_lookup(MPT_ADAPTER *ioc, int i) mptscsih_get_scsi_lookup(MPT_ADAPTER *ioc, int i)
@ -2561,14 +2559,12 @@ mptscsih_get_scsi_lookup(MPT_ADAPTER *ioc, int i)
/** /**
* mptscsih_getclear_scsi_lookup * mptscsih_getclear_scsi_lookup
*
* retrieves and clears scmd entry from ScsiLookup[] array list
*
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @i: index into the array * @i: index into the array
* *
* Returns the scsi_cmd pointer * retrieves and clears scmd entry from ScsiLookup[] array list
* *
* Returns the scsi_cmd pointer
**/ **/
static struct scsi_cmnd * static struct scsi_cmnd *
mptscsih_getclear_scsi_lookup(MPT_ADAPTER *ioc, int i) mptscsih_getclear_scsi_lookup(MPT_ADAPTER *ioc, int i)