From 4194f4b18b957b4a013a3f50d5fde67770d5ccdb Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@duempel.org>
Date: Sun, 1 Mar 2009 20:08:48 +0100
Subject: audio_parser: added API documentation

---
 src/audio_parser.h | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

(limited to 'src')

diff --git a/src/audio_parser.h b/src/audio_parser.h
index 251ce7cef..3101ab207 100644
--- a/src/audio_parser.h
+++ b/src/audio_parser.h
@@ -16,9 +16,9 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
-/*
- * Parser functions for audio related objects.
+/** \file
  *
+ * Parser functions for audio related objects.
  */
 
 #ifndef AUDIO_PARSER_H
@@ -30,6 +30,16 @@
 
 struct audio_format;
 
+/**
+ * Parses a string in the form "SAMPLE_RATE:BITS:CHANNELS" into an
+ * #audio_format.
+ *
+ * @param dest the destination #audio_format struct
+ * @param src the input string
+ * @param error location to store the error occuring, or NULL to
+ * ignore errors
+ * @return true on success
+ */
 bool
 audio_format_parse(struct audio_format *dest, const char *src, GError **error);
 
-- 
cgit v1.2.3