Commit b612b0fa authored by Lee Jones's avatar Lee Jones Committed by Greg Kroah-Hartman

usb: gadget: function: u_uac1_legacy: Demote obvious misuse of kerneldoc to standard comment blocks

No attempt has been made to document any of the demoted functions here.

Fixes the following W=1 kernel build warning(s):

 drivers/usb/gadget/function/u_uac1_legacy.c:30: warning: Function parameter or member 'i' not described in 'snd_interval_refine_set'
 drivers/usb/gadget/function/u_uac1_legacy.c:30: warning: Function parameter or member 'val' not described in 'snd_interval_refine_set'
 drivers/usb/gadget/function/u_uac1_legacy.c:93: warning: Function parameter or member 'snd' not described in 'playback_default_hw_params'
 drivers/usb/gadget/function/u_uac1_legacy.c:153: warning: Function parameter or member 'card' not described in 'u_audio_playback'
 drivers/usb/gadget/function/u_uac1_legacy.c:153: warning: Function parameter or member 'buf' not described in 'u_audio_playback'
 drivers/usb/gadget/function/u_uac1_legacy.c:153: warning: Function parameter or member 'count' not described in 'u_audio_playback'
 drivers/usb/gadget/function/u_uac1_legacy.c:197: warning: Function parameter or member 'card' not described in 'gaudio_open_snd_dev'
 drivers/usb/gadget/function/u_uac1_legacy.c:257: warning: Function parameter or member 'gau' not described in 'gaudio_close_snd_dev'
 drivers/usb/gadget/function/u_uac1_legacy.c:286: warning: Function parameter or member 'card' not described in 'gaudio_setup'
 drivers/usb/gadget/function/u_uac1_legacy.c:303: warning: Function parameter or member 'the_card' not described in 'gaudio_cleanup'

Cc: Felipe Balbi <balbi@kernel.org>
Cc: Bryan Wu <cooloney@kernel.org>
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20200706133341.476881-20-lee.jones@linaro.orgSigned-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 522514e5
...@@ -23,7 +23,7 @@ ...@@ -23,7 +23,7 @@
/*-------------------------------------------------------------------------*/ /*-------------------------------------------------------------------------*/
/** /*
* Some ALSA internal helper functions * Some ALSA internal helper functions
*/ */
static int snd_interval_refine_set(struct snd_interval *i, unsigned int val) static int snd_interval_refine_set(struct snd_interval *i, unsigned int val)
...@@ -86,7 +86,7 @@ static int _snd_pcm_hw_param_set(struct snd_pcm_hw_params *params, ...@@ -86,7 +86,7 @@ static int _snd_pcm_hw_param_set(struct snd_pcm_hw_params *params,
} }
/*-------------------------------------------------------------------------*/ /*-------------------------------------------------------------------------*/
/** /*
* Set default hardware params * Set default hardware params
*/ */
static int playback_default_hw_params(struct gaudio_snd_dev *snd) static int playback_default_hw_params(struct gaudio_snd_dev *snd)
...@@ -146,7 +146,7 @@ static int playback_default_hw_params(struct gaudio_snd_dev *snd) ...@@ -146,7 +146,7 @@ static int playback_default_hw_params(struct gaudio_snd_dev *snd)
return 0; return 0;
} }
/** /*
* Playback audio buffer data by ALSA PCM device * Playback audio buffer data by ALSA PCM device
*/ */
size_t u_audio_playback(struct gaudio *card, void *buf, size_t count) size_t u_audio_playback(struct gaudio *card, void *buf, size_t count)
...@@ -189,7 +189,7 @@ int u_audio_get_playback_rate(struct gaudio *card) ...@@ -189,7 +189,7 @@ int u_audio_get_playback_rate(struct gaudio *card)
return card->playback.rate; return card->playback.rate;
} }
/** /*
* Open ALSA PCM and control device files * Open ALSA PCM and control device files
* Initial the PCM or control device * Initial the PCM or control device
*/ */
...@@ -250,7 +250,7 @@ static int gaudio_open_snd_dev(struct gaudio *card) ...@@ -250,7 +250,7 @@ static int gaudio_open_snd_dev(struct gaudio *card)
return 0; return 0;
} }
/** /*
* Close ALSA PCM and control device files * Close ALSA PCM and control device files
*/ */
static int gaudio_close_snd_dev(struct gaudio *gau) static int gaudio_close_snd_dev(struct gaudio *gau)
...@@ -275,7 +275,7 @@ static int gaudio_close_snd_dev(struct gaudio *gau) ...@@ -275,7 +275,7 @@ static int gaudio_close_snd_dev(struct gaudio *gau)
return 0; return 0;
} }
/** /*
* gaudio_setup - setup ALSA interface and preparing for USB transfer * gaudio_setup - setup ALSA interface and preparing for USB transfer
* *
* This sets up PCM, mixer or MIDI ALSA devices fore USB gadget using. * This sets up PCM, mixer or MIDI ALSA devices fore USB gadget using.
...@@ -294,7 +294,7 @@ int gaudio_setup(struct gaudio *card) ...@@ -294,7 +294,7 @@ int gaudio_setup(struct gaudio *card)
} }
/** /*
* gaudio_cleanup - remove ALSA device interface * gaudio_cleanup - remove ALSA device interface
* *
* This is called to free all resources allocated by @gaudio_setup(). * This is called to free all resources allocated by @gaudio_setup().
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment