Skip to contentSkip to conversation

libata: fix kernel-doc warnings

PATCH Applied Randy Dunlap 2 participants 2 messages Jan 21, 2009 – Feb 3, 2009 libata

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 libata: fix kernel-doc warnings

From: Randy Dunlap <[email protected]>

Fix libata kernel-doc warnings:

Warning(linux-next-20090120//drivers/ata/libata-core.c:4720): Excess function parameter 'dev' description in 'ata_qc_new' Warning(linux-next-20090120//drivers/ata/libata-scsi.c:428): No description found for parameter 'ap'

---
 drivers/ata/libata-core.c |    3 +--
 drivers/ata/libata-scsi.c |    1 +
 2 files changed, 2 insertions(+), 2 deletions(-)
drivers/ata/libata-core.c +1 -2
@@ -4709,8 +4709,7 @@ void swap_buf_le16(u16 *buf, unsigned in
 
 /**
  *	ata_qc_new - Request an available ATA command, for queueing
- *	@ap: Port associated with device @dev
- *	@dev: Device from whom we request an available command structure
+ *	@ap: target port
  *
  *	LOCKING:
  *	None.
drivers/ata/libata-scsi.c +1 -0
@@ -414,6 +414,7 @@ int ata_std_bios_param(struct scsi_devic
 
 /**
  *	ata_get_identity - Handler for HDIO_GET_IDENTITY ioctl
+ *	@ap: target port
  *	@sdev: SCSI device to get identify data for
  *	@arg: User buffer area for identify data
  *
Applied
#1 lore raw
Quoted 28 lines · Randy Dunlap

From: Randy Dunlap <[email protected]>

Fix libata kernel-doc warnings:

Warning(linux-next-20090120//drivers/ata/libata-core.c:4720): Excess function parameter 'dev' description in 'ata_qc_new' Warning(linux-next-20090120//drivers/ata/libata-scsi.c:428): No description found for parameter 'ap'

---
 drivers/ata/libata-core.c |    3 +--
 drivers/ata/libata-scsi.c |    1 +
 2 files changed, 2 insertions(+), 2 deletions(-)
drivers/ata/libata-core.c +1 -2
@@ -4709,8 +4709,7 @@ void swap_buf_le16(u16 *buf, unsigned in
 
 /**
  *	ata_qc_new - Request an available ATA command, for queueing
- *	@ap: Port associated with device @dev
- *	@dev: Device from whom we request an available command structure
+ *	@ap: target port
  *
  *	LOCKING:
  *	None.

drivers/ata/libata-scsi.c int ata_std_bios_param(struct scsi_devic · line 419

Quoted 6 lines
drivers/ata/libata-scsi.c +1 -0
@@ -414,6 +414,7 @@ int ata_std_bios_param(struct scsi_devic
 
 /**
  *	ata_get_identity - Handler for HDIO_GET_IDENTITY ioctl
+ *	@ap: target port
  *	@sdev: SCSI device to get identify data for
  *	@arg: User buffer area for identify data

applied to -rc