[PATCH 0/3] ALSA: digigram: fix kernel-doc warnings

[PATCH 0/3] ALSA: digigram: fix kernel-doc warnings

[Pierre-Louis Bossart]

make W=1 reports these warnings with v5.12-rc1.

Pierre-Louis Bossart (3):
  ALSA: vx: fix kernel-doc warning
  ALSA: pci: mixart: fix kernel-doc warning
  ALSA: pci: vx222: fix kernel-doc warning

 sound/drivers/vx/vx_core.c      |  2 +-
 sound/pci/mixart/mixart_hwdep.c |  3 ++-
 sound/pci/vx222/vx222_ops.c     | 10 +++++-----
 3 files changed, 8 insertions(+), 7 deletions(-)

-- 
2.25.1

[PATCH 1/3] ALSA: vx: fix kernel-doc warning

[Pierre-Louis Bossart]

make W=1 warning:

sound/drivers/vx/vx_core.c:410: warning: expecting prototype for
snd_vx_boot_xilinx(). Prototype was for snd_vx_load_boot_image()
instead

Signed-off-by: Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
---
 sound/drivers/vx/vx_core.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sound/drivers/vx/vx_core.c b/sound/drivers/vx/vx_core.c
index d5c65cab195b..a22e5b1a5458 100644
--- a/sound/drivers/vx/vx_core.c
+++ b/sound/drivers/vx/vx_core.c
@@ -402,7 +402,7 @@ int vx_send_rih(struct vx_core *chip, int cmd)
 #define END_OF_RESET_WAIT_TIME		500	/* us */
 
 /**
- * snd_vx_boot_xilinx - boot up the xilinx interface
+ * snd_vx_load_boot_image - boot up the xilinx interface
  * @chip: VX core instance
  * @boot: the boot record to load
  */
-- 
2.25.1

[PATCH 2/3] ALSA: pci: mixart: fix kernel-doc warning

[Pierre-Louis Bossart]

make W=1 warning:

sound/pci/mixart/mixart_hwdep.c:36: warning: expecting prototype for
exit with a timeout(). Prototype was for
mixart_wait_nice_for_register_value() instead

Signed-off-by: Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
---
 sound/pci/mixart/mixart_hwdep.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/sound/pci/mixart/mixart_hwdep.c b/sound/pci/mixart/mixart_hwdep.c
index 13dcb2fd0a85..f579f7698bba 100644
--- a/sound/pci/mixart/mixart_hwdep.c
+++ b/sound/pci/mixart/mixart_hwdep.c
@@ -22,7 +22,8 @@
 
 
 /**
- * wait for a value on a peudo register, exit with a timeout
+ * mixart_wait_nice_for_register_value - wait for a value on a peudo register,
+ * exit with a timeout
  *
  * @mgr: pointer to miXart manager structure
  * @offset: unsigned pseudo_register base + offset of value
-- 
2.25.1

[PATCH 3/3] ALSA: pci: vx222: fix kernel-doc warning

[Pierre-Louis Bossart]

make W=1 warnings:

sound/pci/vx222/vx222_ops.c:86: warning: expecting prototype for
snd_vx_inb(). Prototype was for vx2_inb() instead

sound/pci/vx222/vx222_ops.c:97: warning: expecting prototype for
snd_vx_outb(). Prototype was for vx2_outb() instead

sound/pci/vx222/vx222_ops.c:110: warning: expecting prototype for
snd_vx_inl(). Prototype was for vx2_inl() instead

sound/pci/vx222/vx222_ops.c:121: warning: expecting prototype for
snd_vx_outl(). Prototype was for vx2_outl() instead

sound/pci/vx222/vx222_ops.c:221: warning: expecting prototype for
vx_setup_pseudo_dma(). Prototype was for vx2_setup_pseudo_dma()
instead

Signed-off-by: Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
---
 sound/pci/vx222/vx222_ops.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/sound/pci/vx222/vx222_ops.c b/sound/pci/vx222/vx222_ops.c
index 23d4338dc553..a05537202738 100644
--- a/sound/pci/vx222/vx222_ops.c
+++ b/sound/pci/vx222/vx222_ops.c
@@ -78,7 +78,7 @@ static inline unsigned long vx2_reg_addr(struct vx_core *_chip, int reg)
 }
 
 /**
- * snd_vx_inb - read a byte from the register
+ * vx2_inb - read a byte from the register
  * @chip: VX core instance
  * @offset: register enum
  */
@@ -88,7 +88,7 @@ static unsigned char vx2_inb(struct vx_core *chip, int offset)
 }
 
 /**
- * snd_vx_outb - write a byte on the register
+ * vx2_outb - write a byte on the register
  * @chip: VX core instance
  * @offset: the register offset
  * @val: the value to write
@@ -102,7 +102,7 @@ static void vx2_outb(struct vx_core *chip, int offset, unsigned char val)
 }
 
 /**
- * snd_vx_inl - read a 32bit word from the register
+ * vx2_inl - read a 32bit word from the register
  * @chip: VX core instance
  * @offset: register enum
  */
@@ -112,7 +112,7 @@ static unsigned int vx2_inl(struct vx_core *chip, int offset)
 }
 
 /**
- * snd_vx_outl - write a 32bit word on the register
+ * vx2_outl - write a 32bit word on the register
  * @chip: VX core instance
  * @offset: the register enum
  * @val: the value to write
@@ -213,7 +213,7 @@ static int vx2_test_xilinx(struct vx_core *_chip)
 
 
 /**
- * vx_setup_pseudo_dma - set up the pseudo dma read/write mode.
+ * vx2_setup_pseudo_dma - set up the pseudo dma read/write mode.
  * @chip: VX core instance
  * @do_write: 0 = read, 1 = set up for DMA write
  */
-- 
2.25.1

Re: [PATCH 0/3] ALSA: digigram: fix kernel-doc warnings

[Takashi Iwai]

On Tue, 02 Mar 2021 22:54:27 +0100,
Pierre-Louis Bossart wrote:
> 
> make W=1 reports these warnings with v5.12-rc1.
> 
> Pierre-Louis Bossart (3):
>   ALSA: vx: fix kernel-doc warning
>   ALSA: pci: mixart: fix kernel-doc warning
>   ALSA: pci: vx222: fix kernel-doc warning

Applied all three patches now.  Thanks.


Takashi