Staging: pata_rdc: remove pointless comments

These comments contribute nothing to the code, and most were just cut
and pasted from another driver.

Cc: Kevin Huang  <Kevin.Huang@rdc.com.tw>
Cc: Tomy Wang <Tomy.Wang@rdc.com.tw>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>

1 files changed, 10 insertions, 73 deletions

diff --git a/drivers/staging/pata_rdc/pata_rdc.c b/drivers/staging/pata_rdc/pata_rdc.c
index f87863c547ec..6252745250ef 100644
--- a/drivers/staging/pata_rdc/pata_rdc.c
+++ b/drivers/staging/pata_rdc/pata_rdc.c
@@ -617,23 +617,6 @@ funcexit:
 	return funcresult;
 }
 
-/**
- *    Set port up for dma.
- *    @ap: Port to initialize
- *
- *    Called just after data structures for each port are
- *    initialized.  Allocates space for PRD table if the device
- *    is DMA capable SFF.
-
-    Some drivers also use this entry point as a chance to allocate driverprivate
-    memory for ap->private_data.
-
- *
- *    May be used as the port_start() entry in ata_port_operations.
- *
- *    LOCKING:
- *    Inherited from caller.
- */
 static int rdc_pata_port_start(struct ata_port *ap)
 {
 	uint    Channel;
@@ -657,14 +640,6 @@ static void rdc_pata_port_stop(struct ata_port *ap)
 	dev_dbg(ap->dev, "%s Channel: %u\n", __func__, Channel);
 }
 
-/**
- *    prereset for PATA host controller
- *    @link: Target link
- *    @deadline: deadline jiffies for the operation
- *
- *    LOCKING:
- *    None (inherited from caller).
- */
 static int rdc_pata_prereset(struct ata_link *link, unsigned long deadline)
 {
 	struct pci_dev *pdev;
@@ -690,16 +665,6 @@ static int rdc_pata_prereset(struct ata_link *link, unsigned long deadline)
 	}
 }
 
-/**
- *    Probe host controller cable detect info
- *    @ap: Port for which cable detect info is desired
- *
- *    Read cable indicator from ATA PCI device's PCI config
- *    register.  This register is normally set by firmware (BIOS).
- *
- *    LOCKING:
- *    None (inherited from caller).
- */
 static int rdc_pata_cable_detect(struct ata_port *ap)
 {
 	struct pci_dev *pdev;
@@ -732,16 +697,6 @@ static int rdc_pata_cable_detect(struct ata_port *ap)
 	}
 }
 
-/**
- *    Initialize host controller PATA PIO timings
- *    @ap: Port whose timings we are configuring
- *    @adev: um
- *
- *    Set PIO mode for device, in host controller PCI config space.
- *
- *    LOCKING:
- *    None (inherited from caller).
- */
 static void rdc_pata_set_piomode(struct ata_port *ap, struct ata_device *adev)
 {
 	struct pci_dev *pdev;
@@ -782,14 +737,14 @@ static void rdc_pata_set_piomode(struct ata_port *ap, struct ata_device *adev)
 		    pdev,
 		    DeviceID,
 		    PIOTimingMode,
-		    TRUE,/* DMAEnable, */
+		    TRUE,
 		    PrefetchPostingEnable
 		    );
 
 		ATAHostAdapter_SetPrimaryUDMA(
 		    pdev,
 		    DeviceID,
-		    FALSE,/* UDMAEnable, */
+		    FALSE,
 		    UDMA0
 		    );
 	} else {
@@ -797,14 +752,14 @@ static void rdc_pata_set_piomode(struct ata_port *ap, struct ata_device *adev)
 		    pdev,
 		    DeviceID,
 		    PIOTimingMode,
-		    TRUE,/* DMAEnable, */
+		    TRUE,
 		    PrefetchPostingEnable
 		    );
 
 		ATAHostAdapter_SetSecondaryUDMA(
 		    pdev,
 		    DeviceID,
-		    FALSE,/* UDMAEnable, */
+		    FALSE,
 		    UDMA0
 		    );
 	}
@@ -812,16 +767,6 @@ static void rdc_pata_set_piomode(struct ata_port *ap, struct ata_device *adev)
 		__func__, Channel, DeviceID, PIOTimingMode);
 }
 
-/**
- *    Initialize host controller PATA DMA timings
- *    @ap: Port whose timings we are configuring
- *    @adev: um
- *
- *    Set MW/UDMA mode for device, in host controller PCI config space.
- *
- *    LOCKING:
- *    None (inherited from caller).
- */
 static void rdc_pata_set_dmamode(struct ata_port *ap, struct ata_device *adev)
 {
 	struct pci_dev *pdev;
@@ -855,16 +800,13 @@ static void rdc_pata_set_dmamode(struct ata_port *ap, struct ata_device *adev)
 		UDMAEnable = TRUE;
 	}
 
-	/*if (ap->mdma_mask == 0) {
-	}*/
-
 	if (Channel == 0) {
 		if (DMATimingMode >= XFER_UDMA_0) {
 			/* UDMA */
 			ATAHostAdapter_SetPrimaryPIO(pdev,
 				DeviceID,
 				PIOTimingMode,
-				TRUE,/*DMAEnable,*/
+				TRUE,
 				PrefetchPostingEnable);
 
 			ATAHostAdapter_SetPrimaryUDMA(pdev,
@@ -880,12 +822,12 @@ static void rdc_pata_set_dmamode(struct ata_port *ap, struct ata_device *adev)
 			ATAHostAdapter_SetPrimaryPIO(pdev,
 				DeviceID,
 				(DMATimingMode - XFER_MW_DMA_0) + PIO2, /* MDMA0 = PIO2 */
-				TRUE,/*DMAEnable,*/
+				TRUE,
 				PrefetchPostingEnable);
 
 			ATAHostAdapter_SetPrimaryUDMA(pdev,
 				DeviceID,
-				FALSE,/*UDMAEnable,*/
+				FALSE,
 				UDMA0);
 			dev_dbg(ap->dev,
 				"%s: Channel: %u, DeviceID: %u, MDMA: %u\n",
@@ -898,7 +840,7 @@ static void rdc_pata_set_dmamode(struct ata_port *ap, struct ata_device *adev)
 			ATAHostAdapter_SetSecondaryPIO(pdev,
 				DeviceID,
 				PIOTimingMode,
-				TRUE,/*DMAEnable,*/
+				TRUE,
 				PrefetchPostingEnable);
 
 			ATAHostAdapter_SetSecondaryUDMA(pdev,
@@ -914,12 +856,12 @@ static void rdc_pata_set_dmamode(struct ata_port *ap, struct ata_device *adev)
 			ATAHostAdapter_SetSecondaryPIO(pdev,
 				DeviceID,
 				(DMATimingMode - XFER_MW_DMA_0) + PIO2, /* MDMA0 = PIO2 */
-				TRUE,/*DMAEnable,*/
+				TRUE,
 				PrefetchPostingEnable);
 
 			ATAHostAdapter_SetSecondaryUDMA(pdev,
 				DeviceID,
-				FALSE,/*UDMAEnable,*/
+				FALSE,
 				UDMA0);
 			dev_dbg(ap->dev,
 				"%s: Channel: %u, DeviceID: %u, MDMA: %u \n",
@@ -929,7 +871,6 @@ static void rdc_pata_set_dmamode(struct ata_port *ap, struct ata_device *adev)
 	}
 }
 
-/* pata host template */
 static struct scsi_host_template rdc_pata_sht = {
 	ATA_BMDMA_SHT(KBUILD_MODNAME),
 };
@@ -976,20 +917,16 @@ static int __devinit rdc_init_one(struct pci_dev *pdev,
 	port_info[0] = rdc_pata_port_info[ent->driver_data];
 	port_info[1] = rdc_pata_port_info[ent->driver_data];
 
-	/* enable device and prepare host */
 	rc = pci_enable_device(pdev);
 	if (rc) {
 		dev_dbg(&pdev->dev, "%s pci_enable_device failed\n", __func__);
 		return rc;
 	}
-
-	/* enable interrupt */
 	pci_intx(pdev, 1);
 
 	return ata_pci_sff_init_one(pdev, ppinfo, &rdc_pata_sht, NULL);
 }
 
-/* a pci driver */
 static struct pci_driver rdc_pata_driver = {
 	.name		= KBUILD_MODNAME,
 	.id_table	= rdc_pata_id_table,