From: Andrew Eikum <aeikum@codeweavers.com>
Date: Thu, 19 Jan 2012 11:35:20 +0000 (+0100)
Subject: Remove docs for snd_names_list and snd_names_list_free
X-Git-Tag: android-x86-9.0-r1~972
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=6eafe5db3d8bef25d1afc353c9942c33491e6e3f;p=android-x86%2Fexternal-alsa-lib.git

Remove docs for snd_names_list and snd_names_list_free

No need to have misleading docs for functions that do nothing.

Signed-off-by: Takashi Iwai <tiwai@suse.de>
---

diff --git a/src/names.c b/src/names.c
index e7a68878..000e574f 100644
--- a/src/names.c
+++ b/src/names.c
@@ -36,14 +36,8 @@
 #include "local.h"
 
 /** 
- * \brief Give a list of device names and associated comments for selected interface
- * \param iface a string identifying interface ("pcm", "ctl", "seq", "rawmidi")
- * \param list result - a pointer to list
- * \return A non-negative value if successful, otherwise a negative error code.
+ * \brief This function is unimplemented.
  * \deprecated Since 1.0.14
- *
- * The global configuration files are specified in the environment variable
- * \c ALSA_NAMES_FILE.
  */
 int snd_names_list(const char *iface ATTRIBUTE_UNUSED,
 		   snd_devname_t **list ATTRIBUTE_UNUSED)
@@ -53,11 +47,8 @@ int snd_names_list(const char *iface ATTRIBUTE_UNUSED,
 link_warning(snd_names_list, "Warning: snd_names_list is deprecated, use snd_device_name_hint");
 
 /**
- * \brief Release the list of device names
- * \param list the name list to release
+ * \brief This function is unimplemented.
  * \deprecated Since 1.0.14
- *
- * Releases the list of device names allocated via #snd_names_list().
  */
 void snd_names_list_free(snd_devname_t *list ATTRIBUTE_UNUSED)
 {