Some small modifications to make doxygen happy.

diff --git a/include/conf.h b/include/conf.h
index 825925c..f520342 100644 (file)
--- a/include/conf.h
+++ b/include/conf.h
@@ -98,9 +98,6 @@ int snd_config_get_bool(snd_config_t *conf);
 int snd_config_get_ctl_iface_ascii(const char *ascii);
 int snd_config_get_ctl_iface(snd_config_t *conf);
 
-int snd_config_refer_load(snd_config_t **dst, char **name,
-                         snd_config_t *root, snd_config_t *config);
-
 #ifdef __cplusplus
 }
 #endif

diff --git a/include/global.h b/include/global.h
index a17f963..8e2d56e 100644 (file)
--- a/include/global.h
+++ b/include/global.h
@@ -14,8 +14,11 @@
 
 /** \} */
 
+/** helper macro for SND_DLSYM_BUILD_VERSION */
 #define __SND_DLSYM_VERSION(name, version) _ ## name ## version
+/** build version for versioned dynamic symbol */
 #define SND_DLSYM_BUILD_VERSION(name, version) char __SND_DLSYM_VERSION(name, version)
+/** get version of dynamic symbol as string */
 #define SND_DLSYM_VERSION(version) __STRING(version)
 
 int snd_dlsym_verify(void *handle, const char *name, const char *version);

diff --git a/src/conf.c b/src/conf.c
index 5c2a0cc..ffbc9b4 100644 (file)
--- a/src/conf.c
+++ b/src/conf.c
@@ -1869,6 +1869,9 @@ static int snd_config_hooks(snd_config_t *config, void *private_data)
        return err;
 }
 
+#ifndef DOC_HIDDEN
+SND_DLSYM_BUILD_VERSION(snd_config_hook_load, SND_CONFIG_DLSYM_VERSION_HOOK);
+#endif
 /**
  * \brief Load configuration from specified files
  * \param root Configuration root node
@@ -1877,7 +1880,6 @@ static int snd_config_hooks(snd_config_t *config, void *private_data)
  * \param private_data Private data
  * \return zero if success, otherwise a negative error code
  */
-SND_DLSYM_BUILD_VERSION(snd_config_hook_load, SND_CONFIG_DLSYM_VERSION_HOOK);
 int snd_config_hook_load(snd_config_t *root, snd_config_t *config, snd_config_t **dst, void *private_data)
 {
        snd_config_t *n, *res = NULL;
@@ -2004,6 +2006,9 @@ int snd_config_hook_load(snd_config_t *root, snd_config_t *config, snd_config_t
 int snd_determine_driver(int card, char **driver);
 #endif
 
+#ifndef DOC_HIDDEN
+SND_DLSYM_BUILD_VERSION(snd_config_hook_load_for_all_cards, SND_CONFIG_DLSYM_VERSION_HOOK);
+#endif
 /**
  * \brief Load configuration for all present cards
  * \param root Configuration root node
@@ -2012,7 +2017,6 @@ int snd_determine_driver(int card, char **driver);
  * \param private_data Private data
  * \return zero if success, otherwise a negative error code
  */
-SND_DLSYM_BUILD_VERSION(snd_config_hook_load_for_all_cards, SND_CONFIG_DLSYM_VERSION_HOOK);
 int snd_config_hook_load_for_all_cards(snd_config_t *root, snd_config_t *config, snd_config_t **dst, void *private_data ATTRIBUTE_UNUSED)
 {
        int card = -1, err;