DocBook: fix some comments in drivers/scsi
PATCH 1/1 DocBook: fix some comments in drivers/scsi
Update some kernel-doc comments to match the code
Signed-off-by Martin Waitz <[email protected]>
---
drivers/scsi/ata_piix.c | 1 + drivers/scsi/libata-core.c | 31 +++++++++++++++++-------------- drivers/scsi/libata-scsi.c | 2 ++ 3 files changed, 20 insertions(+), 14 deletions(-)
9ef1bc69154d1f4c7376b4bc676f3370aa79b303
drivers/scsi/ata_piix.c +1 -0
@@ -627,6 +627,7 @@ static int piix_disable_ahci(struct pci_/** * piix_check_450nx_errata - Check for problem 450NX setup +* @ata_dev: the PCI device to check * * Check for the present of 450NX errata #19 and errata #25. If * they are found return an error code so we can turn off DMA
drivers/scsi/libata-core.c +17 -14
@@ -4212,19 +4212,6 @@ err_out: } -/** -* ata_port_start - Set port up for dma. -* @ap: Port to initialize -* -* Called just after data structures for each port are -* initialized. Allocates space for PRD table. -* -* May be used as the port_start() entry in ata_port_operations. -* -* LOCKING: -* Inherited from caller. -*/ -/* * Execute a 'simple' command, that only consists of the opcode 'cmd' itself, * without filling any other registers
@@ -4276,6 +4263,8 @@ static int ata_start_drive(struct ata_po/** * ata_device_resume - wakeup a previously suspended devices +* @ap: port the device is connected to +* @dev: the device to resume * * Kick the drive back into action, by sending it an idle immediate * command and making sure its transfer mode matches between drive
@@ -4298,10 +4287,11 @@ int ata_device_resume(struct ata_port *a/** * ata_device_suspend - prepare a device for suspend +* @ap: port the device is connected to +* @dev: the device to suspend * * Flush the cache on the drive, if appropriate, then issue a * standbynow command. -* */ int ata_device_suspend (struct ata_port *ap,struct ata_device *dev) {
@@ -4315,6 +4305,19 @@ int ata_device_suspend(struct ata_port *return 0 ; } +/** +* ata_port_start - Set port up for dma. +* @ap: Port to initialize +* +* Called just after data structures for each port are +* initialized. Allocates space for PRD table. +* +* May be used as the port_start() entry in ata_port_operations. +* +* LOCKING: +* Inherited from caller. +*/ +int ata_port_start (struct ata_port *ap) {struct device *dev = ap->host_set->dev;
drivers/scsi/libata-scsi.c +2 -0
@@ -2492,6 +2492,8 @@ out_unlock:/** * ata_scsi_simulate - simulate SCSI command on ATA device +* @ap: port the device is connected to +* @dev: the target device * @id: current IDENTIFY data for target device. * @cmd: SCSI command being sent to device. * @done: SCSI command completion function.
Signature · 4 lines
0.99.9.GIT -- Martin Waitz
Quoted 9 lines · Martin Waitz
Update some kernel-doc comments to match the code
Signed-off-by Martin Waitz <[email protected]>---
drivers/scsi/ata_piix.c | 1 + drivers/scsi/libata-core.c | 31 +++++++++++++++++-------------- drivers/scsi/libata-scsi.c | 2 ++
Please copy the maintainer (me and linux-ide), particularly since there are other patches in this area...
Jeff