[kernel-doc] fix various DocBook build problems/warnings

Most serious is fixing include/sound/pcm.h, which breaks the DocBook
build.

The other stuff is just filling in things that cause warnings.

2 files changed, 3 insertions, 2 deletions

diff --git a/drivers/net/wan/syncppp.c b/drivers/net/wan/syncppp.c
index f58c794a963a..b56a7b516d24 100644
--- a/drivers/net/wan/syncppp.c
+++ b/drivers/net/wan/syncppp.c
@@ -1440,6 +1440,7 @@ static void sppp_print_bytes (u_char *p, u16 len)
  *      @skb:   The buffer to process
  *      @dev:   The device it arrived on
  *      @p: Unused
+ *      @orig_dev: Unused
  *
  *      Protocol glue. This drives the deferred processing mode the poorer
  *      cards use. This can be called directly by cards that do not have
diff --git a/drivers/scsi/libata-core.c b/drivers/scsi/libata-core.c
index 9fb9814525a3..5cc53cd9323e 100644
--- a/drivers/scsi/libata-core.c
+++ b/drivers/scsi/libata-core.c
@@ -2531,7 +2531,7 @@ void swap_buf_le16(u16 *buf, unsigned int buf_words)
  *      @ap: port to read/write
  *      @buf: data buffer
  *      @buflen: buffer length
- *      @do_write: read/write
+ *      @write_data: read/write
  *
  *      Transfer data from/to the device data register by MMIO.
  *
@@ -2577,7 +2577,7 @@ static void ata_mmio_data_xfer(struct ata_port *ap, unsigned char *buf,
  *      @ap: port to read/write
  *      @buf: data buffer
  *      @buflen: buffer length
- *      @do_write: read/write
+ *      @write_data: read/write
  *
  *      Transfer data from/to the device data register by PIO.
  *