doxygen: global: silence 'not documented' warnings

From: borine@github
Link: https://github.com/alsa-project/alsa-lib/pull/340
Signed-off-by: Jaroslav Kysela <perex@perex.cz>

diff --git a/include/global.h b/include/global.h
index dfe9bc2b54bf020b35f5f61f57bca3957d04f1b5..f81247695b8000212510affaeeeddf1ddcf587e5 100644 (file)
--- a/include/global.h
+++ b/include/global.h
@@ -128,9 +128,11 @@ int snd_async_handler_get_fd(snd_async_handler_t *handler);
 int snd_async_handler_get_signo(snd_async_handler_t *handler);
 void *snd_async_handler_get_callback_private(snd_async_handler_t *handler);
 
+#ifdef HAVE_SYS_SHM_H
 struct snd_shm_area *snd_shm_area_create(int shmid, void *ptr);
 struct snd_shm_area *snd_shm_area_share(struct snd_shm_area *area);
 int snd_shm_area_destroy(struct snd_shm_area *area);
+#endif
 
 int snd_user_file(const char *file, char **result);
 

diff --git a/src/async.c b/src/async.c
index 8e8481b58885f2e846f6f0f699e351a947b44474..76c6fb9e0077b38d995aaa029641aa8b348f4c2c 100644 (file)
--- a/src/async.c
+++ b/src/async.c
@@ -29,7 +29,9 @@
 #include <signal.h>
 
 static struct sigaction previous_action;
+#ifndef DOC_HIDDEN
 #define MAX_SIG_FUNCTION_CODE 10 /* i.e. SIG_DFL SIG_IGN SIG_HOLD et al */
+#endif /* DOC_HIDDEN */
 
 #ifdef SND_ASYNC_RT_SIGNAL
 /** async signal number */

diff --git a/src/dlmisc.c b/src/dlmisc.c
index bc527f839e4e752150cf52024378477a458c026a..d7aff4565788d2dcd79d286e6446f4c3db917ea4 100644 (file)
--- a/src/dlmisc.c
+++ b/src/dlmisc.c
@@ -170,8 +170,10 @@ EXPORT_SYMBOL void *INTERNAL(snd_dlopen_old)(const char *name, int mode)
 }
 #endif
 
+#ifndef DOC_HIDDEN
 use_symbol_version(__snd_dlopen_old, snd_dlopen, ALSA_0.9);
 use_default_symbol_version(__snd_dlopen, snd_dlopen, ALSA_1.1.6);
+#endif /* DOC_HIDDEN */
 
 /**
  * \brief Closes a dynamic library - ALSA wrapper for \c dlclose.

diff --git a/src/shmarea.c b/src/shmarea.c
index b566c79e7506e1af619a9ffc984fdb6534aa5bf1..4e621f7cebd49643a27d1e010dc0602e53e61558 100644 (file)
--- a/src/shmarea.c
+++ b/src/shmarea.c
@@ -18,6 +18,16 @@
  *
  */
 
+/**
+ * \file shmarea.c
+ * \ingroup Global
+ * \brief shared memory helpers
+ * \author Jaroslav Kysela <perex@perex.cz>
+ * \date 2001
+ *
+ * Shared memory helpers
+ */
+
 #include "config.h"
 
 /* These funcs are only used by pcm_mmap when sys/shm.h is available. */
@@ -102,6 +112,7 @@ int snd_shm_area_destroy(struct snd_shm_area *area)
        return 0;
 }
 
+#ifndef DOC_HIDDEN
 void snd_shm_area_destructor(void) __attribute__ ((destructor));
 
 void snd_shm_area_destructor(void)
@@ -114,5 +125,6 @@ void snd_shm_area_destructor(void)
                shmdt(area->ptr);
        }
 }
+#endif /* DOC_HIDDEN */
 
 #endif