From: Andre Noll <maan@systemlinux.org>
Date: Mon, 5 Feb 2007 22:31:43 +0000 (+0100)
Subject: alsa_write.c: Add missing documentation
X-Git-Tag: v0.2.15~31
X-Git-Url: https://git.tuebingen.mpg.de/?a=commitdiff_plain;h=af50bfb04d6156d588e0a91884debbd917b304dc;p=paraslash.git

alsa_write.c: Add missing documentation
---

diff --git a/alsa_write.c b/alsa_write.c
index 7c090c89..8bac583a 100644
--- a/alsa_write.c
+++ b/alsa_write.c
@@ -36,7 +36,7 @@
 #include "alsa_write.cmdline.h"
 #include "error.h"
 
-
+/** always use 16 bit little endian */
 #define FORMAT SND_PCM_FORMAT_S16_LE
 
 /** data specific to the alsa writer */
@@ -49,7 +49,15 @@ struct private_alsa_write_data {
 	struct timeval next_chunk;
 	/** the return value of snd_pcm_hw_params_get_buffer_time_max() */
 	unsigned buffer_time;
+	/**
+	 * the samplerate given by command line option or the decoder
+	 * of the writer node group
+ 	 */
 	unsigned samplerate;
+	/**
+	 * the number of channels, also given by command line option or the
+	 * decoder of the writer node group
+	 */
 	unsigned channels;
 };
 
@@ -227,7 +235,13 @@ err_out:
 	return NULL;
 }
 
-/** the init function of the alsa writer */
+/**
+ * the init function of the alsa writer
+ *
+ * \param w pointer to the writer to initialize
+ *
+ * \sa struct writer
+ */
 void alsa_write_init(struct writer *w)
 {
 	w->open = alsa_open;