Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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>

+10 -73
+10 -73
drivers/staging/pata_rdc/pata_rdc.c
··· 617 617 return funcresult; 618 618 } 619 619 620 - /** 621 - * Set port up for dma. 622 - * @ap: Port to initialize 623 - * 624 - * Called just after data structures for each port are 625 - * initialized. Allocates space for PRD table if the device 626 - * is DMA capable SFF. 627 - 628 - Some drivers also use this entry point as a chance to allocate driverprivate 629 - memory for ap->private_data. 630 - 631 - * 632 - * May be used as the port_start() entry in ata_port_operations. 633 - * 634 - * LOCKING: 635 - * Inherited from caller. 636 - */ 637 620 static int rdc_pata_port_start(struct ata_port *ap) 638 621 { 639 622 uint Channel; ··· 640 657 dev_dbg(ap->dev, "%s Channel: %u\n", __func__, Channel); 641 658 } 642 659 643 - /** 644 - * prereset for PATA host controller 645 - * @link: Target link 646 - * @deadline: deadline jiffies for the operation 647 - * 648 - * LOCKING: 649 - * None (inherited from caller). 650 - */ 651 660 static int rdc_pata_prereset(struct ata_link *link, unsigned long deadline) 652 661 { 653 662 struct pci_dev *pdev; ··· 665 690 } 666 691 } 667 692 668 - /** 669 - * Probe host controller cable detect info 670 - * @ap: Port for which cable detect info is desired 671 - * 672 - * Read cable indicator from ATA PCI device's PCI config 673 - * register. This register is normally set by firmware (BIOS). 674 - * 675 - * LOCKING: 676 - * None (inherited from caller). 677 - */ 678 693 static int rdc_pata_cable_detect(struct ata_port *ap) 679 694 { 680 695 struct pci_dev *pdev; ··· 697 732 } 698 733 } 699 734 700 - /** 701 - * Initialize host controller PATA PIO timings 702 - * @ap: Port whose timings we are configuring 703 - * @adev: um 704 - * 705 - * Set PIO mode for device, in host controller PCI config space. 706 - * 707 - * LOCKING: 708 - * None (inherited from caller). 709 - */ 710 735 static void rdc_pata_set_piomode(struct ata_port *ap, struct ata_device *adev) 711 736 { 712 737 struct pci_dev *pdev; ··· 737 782 pdev, 738 783 DeviceID, 739 784 PIOTimingMode, 740 - TRUE,/* DMAEnable, */ 785 + TRUE, 741 786 PrefetchPostingEnable 742 787 ); 743 788 744 789 ATAHostAdapter_SetPrimaryUDMA( 745 790 pdev, 746 791 DeviceID, 747 - FALSE,/* UDMAEnable, */ 792 + FALSE, 748 793 UDMA0 749 794 ); 750 795 } else { ··· 752 797 pdev, 753 798 DeviceID, 754 799 PIOTimingMode, 755 - TRUE,/* DMAEnable, */ 800 + TRUE, 756 801 PrefetchPostingEnable 757 802 ); 758 803 759 804 ATAHostAdapter_SetSecondaryUDMA( 760 805 pdev, 761 806 DeviceID, 762 - FALSE,/* UDMAEnable, */ 807 + FALSE, 763 808 UDMA0 764 809 ); 765 810 } ··· 767 812 __func__, Channel, DeviceID, PIOTimingMode); 768 813 } 769 814 770 - /** 771 - * Initialize host controller PATA DMA timings 772 - * @ap: Port whose timings we are configuring 773 - * @adev: um 774 - * 775 - * Set MW/UDMA mode for device, in host controller PCI config space. 776 - * 777 - * LOCKING: 778 - * None (inherited from caller). 779 - */ 780 815 static void rdc_pata_set_dmamode(struct ata_port *ap, struct ata_device *adev) 781 816 { 782 817 struct pci_dev *pdev; ··· 800 855 UDMAEnable = TRUE; 801 856 } 802 857 803 - /*if (ap->mdma_mask == 0) { 804 - }*/ 805 - 806 858 if (Channel == 0) { 807 859 if (DMATimingMode >= XFER_UDMA_0) { 808 860 /* UDMA */ 809 861 ATAHostAdapter_SetPrimaryPIO(pdev, 810 862 DeviceID, 811 863 PIOTimingMode, 812 - TRUE,/*DMAEnable,*/ 864 + TRUE, 813 865 PrefetchPostingEnable); 814 866 815 867 ATAHostAdapter_SetPrimaryUDMA(pdev, ··· 822 880 ATAHostAdapter_SetPrimaryPIO(pdev, 823 881 DeviceID, 824 882 (DMATimingMode - XFER_MW_DMA_0) + PIO2, /* MDMA0 = PIO2 */ 825 - TRUE,/*DMAEnable,*/ 883 + TRUE, 826 884 PrefetchPostingEnable); 827 885 828 886 ATAHostAdapter_SetPrimaryUDMA(pdev, 829 887 DeviceID, 830 - FALSE,/*UDMAEnable,*/ 888 + FALSE, 831 889 UDMA0); 832 890 dev_dbg(ap->dev, 833 891 "%s: Channel: %u, DeviceID: %u, MDMA: %u\n", ··· 840 898 ATAHostAdapter_SetSecondaryPIO(pdev, 841 899 DeviceID, 842 900 PIOTimingMode, 843 - TRUE,/*DMAEnable,*/ 901 + TRUE, 844 902 PrefetchPostingEnable); 845 903 846 904 ATAHostAdapter_SetSecondaryUDMA(pdev, ··· 856 914 ATAHostAdapter_SetSecondaryPIO(pdev, 857 915 DeviceID, 858 916 (DMATimingMode - XFER_MW_DMA_0) + PIO2, /* MDMA0 = PIO2 */ 859 - TRUE,/*DMAEnable,*/ 917 + TRUE, 860 918 PrefetchPostingEnable); 861 919 862 920 ATAHostAdapter_SetSecondaryUDMA(pdev, 863 921 DeviceID, 864 - FALSE,/*UDMAEnable,*/ 922 + FALSE, 865 923 UDMA0); 866 924 dev_dbg(ap->dev, 867 925 "%s: Channel: %u, DeviceID: %u, MDMA: %u \n", ··· 871 929 } 872 930 } 873 931 874 - /* pata host template */ 875 932 static struct scsi_host_template rdc_pata_sht = { 876 933 ATA_BMDMA_SHT(KBUILD_MODNAME), 877 934 }; ··· 917 976 port_info[0] = rdc_pata_port_info[ent->driver_data]; 918 977 port_info[1] = rdc_pata_port_info[ent->driver_data]; 919 978 920 - /* enable device and prepare host */ 921 979 rc = pci_enable_device(pdev); 922 980 if (rc) { 923 981 dev_dbg(&pdev->dev, "%s pci_enable_device failed\n", __func__); 924 982 return rc; 925 983 } 926 - 927 - /* enable interrupt */ 928 984 pci_intx(pdev, 1); 929 985 930 986 return ata_pci_sff_init_one(pdev, ppinfo, &rdc_pata_sht, NULL); 931 987 } 932 988 933 - /* a pci driver */ 934 989 static struct pci_driver rdc_pata_driver = { 935 990 .name = KBUILD_MODNAME, 936 991 .id_table = rdc_pata_id_table,