ata: pata_acpi: Fix some incorrect function param descriptions
authorLee Jones <lee.jones@linaro.org>
Thu, 18 Mar 2021 08:51:50 +0000 (08:51 +0000)
committerJens Axboe <axboe@kernel.dk>
Wed, 31 Mar 2021 02:21:26 +0000 (20:21 -0600)
Fixes the following W=1 kernel build warning(s):

 drivers/ata/pata_acpi.c:38: warning: Function parameter or member 'link' not described in 'pacpi_pre_reset'
 drivers/ata/pata_acpi.c:38: warning: Excess function parameter 'ap' description in 'pacpi_pre_reset'
 drivers/ata/pata_acpi.c:74: warning: Function parameter or member 'ap' not described in 'pacpi_discover_modes'
 drivers/ata/pata_acpi.c:74: warning: Excess function parameter 'mask' description in 'pacpi_discover_modes'
 drivers/ata/pata_acpi.c:239: warning: Function parameter or member 'id' not described in 'pacpi_init_one'
 drivers/ata/pata_acpi.c:239: warning: Excess function parameter 'ent' description in 'pacpi_init_one'

Cc: Jens Axboe <axboe@kernel.dk>
Cc: linux-ide@vger.kernel.org
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20210318085150.3131936-16-lee.jones@linaro.org
Signed-off-by: Jens Axboe <axboe@kernel.dk>
drivers/ata/pata_acpi.c

index fa2bfc3..ade4c3e 100644 (file)
@@ -28,7 +28,7 @@ struct pata_acpi {
 
 /**
  *     pacpi_pre_reset -       check for 40/80 pin
- *     @ap: Port
+ *     @link: ATA link
  *     @deadline: deadline jiffies for the operation
  *
  *     Perform the PATA port setup we need.
@@ -63,8 +63,8 @@ static int pacpi_cable_detect(struct ata_port *ap)
 
 /**
  *     pacpi_discover_modes    -       filter non ACPI modes
+ *     @ap: ATA port
  *     @adev: ATA device
- *     @mask: proposed modes
  *
  *     Try the modes available and see which ones the ACPI method will
  *     set up sensibly. From this we get a mask of ACPI modes we can use
@@ -224,7 +224,7 @@ static struct ata_port_operations pacpi_ops = {
 /**
  *     pacpi_init_one - Register ACPI ATA PCI device with kernel services
  *     @pdev: PCI device to register
- *     @ent: Entry in pacpi_pci_tbl matching with @pdev
+ *     @id: PCI device ID
  *
  *     Called from kernel PCI layer.
  *