Commit 3531ba21 authored by Pierre-Louis Bossart's avatar Pierre-Louis Bossart Committed by Takashi Iwai

ALSA: hda: fix kernel-doc warnings

v5.12-rc1 flags new warnings with make W=1, fix missing or broken
function descriptors.

sound/pci/hda/hda_codec.c:3492: warning: expecting prototype for
snd_hda_input_mux_info_info(). Prototype was for
snd_hda_input_mux_info() instead

sound/pci/hda/hda_codec.c:3521: warning: expecting prototype for
snd_hda_input_mux_info_put(). Prototype was for
snd_hda_input_mux_put() instead

sound/pci/hda/hda_codec.c:3958: warning: expecting prototype for
_snd_hda_pin_ctl(). Prototype was for _snd_hda_set_pin_ctl() instead

sound/pci/hda/hda_jack.c:223: warning: expecting prototype for
snd_hda_set_dirty_all(). Prototype was for
snd_hda_jack_set_dirty_all() instead

sound/pci/hda/hda_jack.c:309: warning: expecting prototype for
snd_hda_jack_detect_enable_mst(). Prototype was for
snd_hda_jack_detect_enable_callback_mst() instead

sound/pci/hda/hda_generic.c:3933: warning: expecting prototype for
snd_dha_gen_add_mute_led_cdev(). Prototype was for
snd_hda_gen_add_mute_led_cdev() instead

sound/pci/hda/hda_generic.c:4093: warning: expecting prototype for
snd_dha_gen_add_micmute_led_cdev(). Prototype was for
snd_hda_gen_add_micmute_led_cdev() instead

sound/pci/hda/patch_ca0132.c:2357: warning: expecting prototype for
Prepare and send the SCP message to DSP(). Prototype was for
dspio_scp() instead

sound/pci/hda/patch_ca0132.c:2883: warning: expecting prototype for
Allocate router ports(). Prototype was for dsp_allocate_router_ports()
instead

sound/pci/hda/patch_ca0132.c:3202: warning: expecting prototype for
Write a block of data into DSP code or data RAM using pre(). Prototype
was for dspxfr_one_seg() instead

sound/pci/hda/patch_ca0132.c:3397: warning: expecting prototype for
data overlay to DSP memories(). Prototype was for dspxfr_image()
instead

sound/hda/hdac_regmap.c:393: warning: expecting prototype for
snd_hdac_regmap_init(). Prototype was for snd_hdac_regmap_exit()
instead

sound/hda/ext/hdac_ext_controller.c:142: warning: expecting prototype
for snd_hdac_ext_bus_get_link_index(). Prototype was for
snd_hdac_ext_bus_get_link() instead

sound/hda/ext/hdac_ext_stream.c:140: warning: expecting prototype for
snd_hdac_ext_linkstream_start(). Prototype was for
snd_hdac_ext_link_stream_start() instead
Signed-off-by: default avatarPierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
Link: https://lore.kernel.org/r/20210301174617.116960-1-pierre-louis.bossart@linux.intel.comSigned-off-by: default avatarTakashi Iwai <tiwai@suse.de>
parent 2c911900
...@@ -133,7 +133,7 @@ void snd_hdac_link_free_all(struct hdac_bus *bus) ...@@ -133,7 +133,7 @@ void snd_hdac_link_free_all(struct hdac_bus *bus)
EXPORT_SYMBOL_GPL(snd_hdac_link_free_all); EXPORT_SYMBOL_GPL(snd_hdac_link_free_all);
/** /**
* snd_hdac_ext_bus_get_link_index - get link based on codec name * snd_hdac_ext_bus_get_link - get link based on codec name
* @bus: the pointer to HDAC bus object * @bus: the pointer to HDAC bus object
* @codec_name: codec name * @codec_name: codec name
*/ */
......
...@@ -133,7 +133,7 @@ void snd_hdac_ext_stream_decouple(struct hdac_bus *bus, ...@@ -133,7 +133,7 @@ void snd_hdac_ext_stream_decouple(struct hdac_bus *bus,
EXPORT_SYMBOL_GPL(snd_hdac_ext_stream_decouple); EXPORT_SYMBOL_GPL(snd_hdac_ext_stream_decouple);
/** /**
* snd_hdac_ext_linkstream_start - start a stream * snd_hdac_ext_link_stream_start - start a stream
* @stream: HD-audio ext core stream to start * @stream: HD-audio ext core stream to start
*/ */
void snd_hdac_ext_link_stream_start(struct hdac_ext_stream *stream) void snd_hdac_ext_link_stream_start(struct hdac_ext_stream *stream)
......
...@@ -386,7 +386,7 @@ int snd_hdac_regmap_init(struct hdac_device *codec) ...@@ -386,7 +386,7 @@ int snd_hdac_regmap_init(struct hdac_device *codec)
EXPORT_SYMBOL_GPL(snd_hdac_regmap_init); EXPORT_SYMBOL_GPL(snd_hdac_regmap_init);
/** /**
* snd_hdac_regmap_init - Release the regmap from HDA codec * snd_hdac_regmap_exit - Release the regmap from HDA codec
* @codec: the codec object * @codec: the codec object
*/ */
void snd_hdac_regmap_exit(struct hdac_device *codec) void snd_hdac_regmap_exit(struct hdac_device *codec)
......
...@@ -3483,7 +3483,7 @@ EXPORT_SYMBOL_GPL(snd_hda_check_amp_list_power); ...@@ -3483,7 +3483,7 @@ EXPORT_SYMBOL_GPL(snd_hda_check_amp_list_power);
*/ */
/** /**
* snd_hda_input_mux_info_info - Info callback helper for the input-mux enum * snd_hda_input_mux_info - Info callback helper for the input-mux enum
* @imux: imux helper object * @imux: imux helper object
* @uinfo: pointer to get/store the data * @uinfo: pointer to get/store the data
*/ */
...@@ -3506,7 +3506,7 @@ int snd_hda_input_mux_info(const struct hda_input_mux *imux, ...@@ -3506,7 +3506,7 @@ int snd_hda_input_mux_info(const struct hda_input_mux *imux,
EXPORT_SYMBOL_GPL(snd_hda_input_mux_info); EXPORT_SYMBOL_GPL(snd_hda_input_mux_info);
/** /**
* snd_hda_input_mux_info_put - Put callback helper for the input-mux enum * snd_hda_input_mux_put - Put callback helper for the input-mux enum
* @codec: the HDA codec * @codec: the HDA codec
* @imux: imux helper object * @imux: imux helper object
* @ucontrol: pointer to get/store the data * @ucontrol: pointer to get/store the data
...@@ -3941,7 +3941,7 @@ unsigned int snd_hda_correct_pin_ctl(struct hda_codec *codec, ...@@ -3941,7 +3941,7 @@ unsigned int snd_hda_correct_pin_ctl(struct hda_codec *codec,
EXPORT_SYMBOL_GPL(snd_hda_correct_pin_ctl); EXPORT_SYMBOL_GPL(snd_hda_correct_pin_ctl);
/** /**
* _snd_hda_pin_ctl - Helper to set pin ctl value * _snd_hda_set_pin_ctl - Helper to set pin ctl value
* @codec: the HDA codec * @codec: the HDA codec
* @pin: referred pin NID * @pin: referred pin NID
* @val: pin control value to set * @val: pin control value to set
......
...@@ -3923,7 +3923,7 @@ static void vmaster_update_mute_led(void *private_data, int enabled) ...@@ -3923,7 +3923,7 @@ static void vmaster_update_mute_led(void *private_data, int enabled)
} }
/** /**
* snd_dha_gen_add_mute_led_cdev - Create a LED classdev and enable as vmaster mute LED * snd_hda_gen_add_mute_led_cdev - Create a LED classdev and enable as vmaster mute LED
* @codec: the HDA codec * @codec: the HDA codec
* @callback: the callback for LED classdev brightness_set_blocking * @callback: the callback for LED classdev brightness_set_blocking
*/ */
...@@ -4074,7 +4074,7 @@ static int add_micmute_led_hook(struct hda_codec *codec) ...@@ -4074,7 +4074,7 @@ static int add_micmute_led_hook(struct hda_codec *codec)
} }
/** /**
* snd_dha_gen_add_micmute_led_cdev - Create a LED classdev and enable as mic-mute LED * snd_hda_gen_add_micmute_led_cdev - Create a LED classdev and enable as mic-mute LED
* @codec: the HDA codec * @codec: the HDA codec
* @callback: the callback for LED classdev brightness_set_blocking * @callback: the callback for LED classdev brightness_set_blocking
* *
......
...@@ -213,7 +213,7 @@ static void jack_detect_update(struct hda_codec *codec, ...@@ -213,7 +213,7 @@ static void jack_detect_update(struct hda_codec *codec,
} }
/** /**
* snd_hda_set_dirty_all - Mark all the cached as dirty * snd_hda_jack_set_dirty_all - Mark all the cached as dirty
* @codec: the HDA codec * @codec: the HDA codec
* *
* This function sets the dirty flag to all entries of jack table. * This function sets the dirty flag to all entries of jack table.
...@@ -293,7 +293,7 @@ find_callback_from_list(struct hda_jack_tbl *jack, ...@@ -293,7 +293,7 @@ find_callback_from_list(struct hda_jack_tbl *jack,
} }
/** /**
* snd_hda_jack_detect_enable_mst - enable the jack-detection * snd_hda_jack_detect_enable_callback_mst - enable the jack-detection
* @codec: the HDA codec * @codec: the HDA codec
* @nid: pin NID to enable * @nid: pin NID to enable
* @func: callback function to register * @func: callback function to register
......
...@@ -2338,7 +2338,7 @@ static int dspio_send_scp_message(struct hda_codec *codec, ...@@ -2338,7 +2338,7 @@ static int dspio_send_scp_message(struct hda_codec *codec,
} }
/** /**
* Prepare and send the SCP message to DSP * dspio_scp - Prepare and send the SCP message to DSP
* @codec: the HDA codec * @codec: the HDA codec
* @mod_id: ID of the DSP module to send the command * @mod_id: ID of the DSP module to send the command
* @src_id: ID of the source * @src_id: ID of the source
...@@ -2865,7 +2865,7 @@ static int dsp_dma_stop(struct hda_codec *codec, ...@@ -2865,7 +2865,7 @@ static int dsp_dma_stop(struct hda_codec *codec,
} }
/** /**
* Allocate router ports * dsp_allocate_router_ports - Allocate router ports
* *
* @codec: the HDA codec * @codec: the HDA codec
* @num_chans: number of channels in the stream * @num_chans: number of channels in the stream
...@@ -3178,8 +3178,7 @@ static int dspxfr_hci_write(struct hda_codec *codec, ...@@ -3178,8 +3178,7 @@ static int dspxfr_hci_write(struct hda_codec *codec,
} }
/** /**
* Write a block of data into DSP code or data RAM using pre-allocated * dspxfr_one_seg - Write a block of data into DSP code or data RAM using pre-allocated DMA engine.
* DMA engine.
* *
* @codec: the HDA codec * @codec: the HDA codec
* @fls: pointer to a fast load image * @fls: pointer to a fast load image
...@@ -3376,7 +3375,7 @@ static int dspxfr_one_seg(struct hda_codec *codec, ...@@ -3376,7 +3375,7 @@ static int dspxfr_one_seg(struct hda_codec *codec,
} }
/** /**
* Write the entire DSP image of a DSP code/data overlay to DSP memories * dspxfr_image - Write the entire DSP image of a DSP code/data overlay to DSP memories
* *
* @codec: the HDA codec * @codec: the HDA codec
* @fls_data: pointer to a fast load image * @fls_data: pointer to a fast load image
......
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