diff mbox

fm801: convert struct description to kernel-doc

Message ID 1400497648-32005-1-git-send-email-andriy.shevchenko@linux.intel.com (mailing list archive)
State Accepted
Commit 052c233e9800b1f7da4c18cb1660576249486a73
Delegated to: Takashi Iwai
Headers show

Commit Message

Andy Shevchenko May 19, 2014, 11:07 a.m. UTC
Just move field descriptions to the struct description in the kernel-doc
format. There is no functional change.

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
 sound/pci/fm801.c | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

Comments

Takashi Iwai May 19, 2014, 12:34 p.m. UTC | #1
At Mon, 19 May 2014 14:07:28 +0300,
Andy Shevchenko wrote:
> 
> Just move field descriptions to the struct description in the kernel-doc
> format. There is no functional change.
> 
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>

Thanks, applied.


Takashi

> ---
>  sound/pci/fm801.c | 26 ++++++++++++++++----------
>  1 file changed, 16 insertions(+), 10 deletions(-)
> 
> diff --git a/sound/pci/fm801.c b/sound/pci/fm801.c
> index e8910d0..529f5f4 100644
> --- a/sound/pci/fm801.c
> +++ b/sound/pci/fm801.c
> @@ -158,21 +158,27 @@ MODULE_PARM_DESC(radio_nr, "Radio device numbers");
>  #define FM801_GPIO_GS3		(1<<15)
>  #define FM801_GPIO_GS(x)	(1<<(12+(x)))
>  	
> -/*
> -
> +/**
> + * struct fm801 - describes FM801 chip
> + * @port:		I/O port number
> + * @multichannel:	multichannel support
> + * @secondary:		secondary codec
> + * @secondary_addr:	address of the secondary codec
> + * @tea575x_tuner:	tuner access method & flags
> + * @ply_ctrl:		playback control
> + * @cap_ctrl:		capture control
>   */
> -
>  struct fm801 {
>  	int irq;
>  
> -	unsigned long port;	/* I/O port number */
> -	unsigned int multichannel: 1,	/* multichannel support */
> -		     secondary: 1;	/* secondary codec */
> -	unsigned char secondary_addr;	/* address of the secondary codec */
> -	unsigned int tea575x_tuner;	/* tuner access method & flags */
> +	unsigned long port;
> +	unsigned int multichannel: 1,
> +		     secondary: 1;
> +	unsigned char secondary_addr;
> +	unsigned int tea575x_tuner;
>  
> -	unsigned short ply_ctrl; /* playback control */
> -	unsigned short cap_ctrl; /* capture control */
> +	unsigned short ply_ctrl;
> +	unsigned short cap_ctrl;
>  
>  	unsigned long ply_buffer;
>  	unsigned int ply_buf;
> -- 
> 2.0.0.rc2
>
diff mbox

Patch

diff --git a/sound/pci/fm801.c b/sound/pci/fm801.c
index e8910d0..529f5f4 100644
--- a/sound/pci/fm801.c
+++ b/sound/pci/fm801.c
@@ -158,21 +158,27 @@  MODULE_PARM_DESC(radio_nr, "Radio device numbers");
 #define FM801_GPIO_GS3		(1<<15)
 #define FM801_GPIO_GS(x)	(1<<(12+(x)))
 	
-/*
-
+/**
+ * struct fm801 - describes FM801 chip
+ * @port:		I/O port number
+ * @multichannel:	multichannel support
+ * @secondary:		secondary codec
+ * @secondary_addr:	address of the secondary codec
+ * @tea575x_tuner:	tuner access method & flags
+ * @ply_ctrl:		playback control
+ * @cap_ctrl:		capture control
  */
-
 struct fm801 {
 	int irq;
 
-	unsigned long port;	/* I/O port number */
-	unsigned int multichannel: 1,	/* multichannel support */
-		     secondary: 1;	/* secondary codec */
-	unsigned char secondary_addr;	/* address of the secondary codec */
-	unsigned int tea575x_tuner;	/* tuner access method & flags */
+	unsigned long port;
+	unsigned int multichannel: 1,
+		     secondary: 1;
+	unsigned char secondary_addr;
+	unsigned int tea575x_tuner;
 
-	unsigned short ply_ctrl; /* playback control */
-	unsigned short cap_ctrl; /* capture control */
+	unsigned short ply_ctrl;
+	unsigned short cap_ctrl;
 
 	unsigned long ply_buffer;
 	unsigned int ply_buf;