mirrors/alsa-lib
1
0
Fork 0
mirror of https://github.com/alsa-project/alsa-lib.git synced 2025-11-03 09:01:52 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

doxygen: namehint: silence 'not documented' warnings

Browse source 
Also creates a new module within the Configuration interface
documentation in which to present the name hint docs.

From: borine@github
Link: https://github.com/alsa-project/alsa-lib/pull/340
Signed-off-by: Jaroslav Kysela <perex@perex.cz>
This commit is contained in:
borine 2023-07-30 10:58:23 +01:00 • committed by Jaroslav Kysela
parent 47228e4e6e
commit 382c700dfe
3 changed files with 16 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

1
doc/doxygen.cfg.in
View file

@ -50,6 +50,7 @@ INPUT = @top_srcdir@/doc/index.doxygen \
@top_srcdir@/src/control/control_shm.c \ @top_srcdir@/src/control/control_shm.c \
@top_srcdir@/src/control/ctlparse.c \ @top_srcdir@/src/control/ctlparse.c \
@top_srcdir@/src/control/hcontrol.c \ @top_srcdir@/src/control/hcontrol.c \
@top_srcdir@/src/control/namehint.c \
@top_srcdir@/src/control/setup.c \ @top_srcdir@/src/control/setup.c \
@top_srcdir@/src/control/tlv.c \ @top_srcdir@/src/control/tlv.c \
@top_srcdir@/src/mixer \ @top_srcdir@/src/mixer \

18
include/control.h
View file

@ -374,10 +374,6 @@ int snd_card_get_index(const char *name);
int snd_card_get_name(int card, char **name); int snd_card_get_name(int card, char **name);
int snd_card_get_longname(int card, char **name); int snd_card_get_longname(int card, char **name);
int snd_device_name_hint(int card, const char *iface, void ***hints);
int snd_device_name_free_hint(void **hints);
char *snd_device_name_get_hint(const void *hint, const char *id);
int snd_ctl_open(snd_ctl_t **ctl, const char *name, int mode); int snd_ctl_open(snd_ctl_t **ctl, const char *name, int mode);
int snd_ctl_open_lconf(snd_ctl_t **ctl, const char *name, int mode, snd_config_t *lconf); int snd_ctl_open_lconf(snd_ctl_t **ctl, const char *name, int mode, snd_config_t *lconf);
int snd_ctl_open_fallback(snd_ctl_t **ctl, snd_config_t *root, const char *name, const char *orig_name, int mode); int snd_ctl_open_fallback(snd_ctl_t **ctl, snd_config_t *root, const char *name, const char *orig_name, int mode);
@ -797,6 +793,20 @@ int snd_sctl_remove(snd_sctl_t *handle);
/** \} */ /** \} */
/**
* \defgroup Hint Name Hint Interface
* \ingroup Configuration
* The name hint interface - get descriptive information about a device
* (name, description, input/output).
* \{
*/
int snd_device_name_hint(int card, const char *iface, void ***hints);
int snd_device_name_free_hint(void **hints);
char *snd_device_name_get_hint(const void *hint, const char *id);
/** \} */
#ifdef __cplusplus #ifdef __cplusplus
} }
#endif #endif

1
src/control/namehint.c
View file

@ -1,5 +1,6 @@
/** /**
* \file control/namehint.c * \file control/namehint.c
* \ingroup Configuration
* \brief Give device name hints * \brief Give device name hints
* \author Jaroslav Kysela <perex@perex.cz> * \author Jaroslav Kysela <perex@perex.cz>
* \date 2006 * \date 2006