X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=wav.c;h=308c8bc1f36ee04aecef216a94e49094a45ab20f;hp=5ab3bb3937385a855e7dd5fecdcc50635e3d1ac2;hb=79fe17bc95ac8f14398279954d5f033ad75b8395;hpb=2a8029478dfc65f0c935d864faf4aea9e3deb27d

diff --git a/wav.c b/wav.c
index 5ab3bb39..308c8bc1 100644
--- a/wav.c
+++ b/wav.c
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2005-2006 Andre Noll <maan@systemlinux.org>
+ * Copyright (C) 2005-2007 Andre Noll <maan@systemlinux.org>
  *
  *     This program is free software; you can redistribute it and/or modify
  *     it under the terms of the GNU General Public License as published by
@@ -25,15 +25,30 @@
 #include "filter.h"
 #include "string.h"
 
+/** size of the output buffer */
 #define WAV_OUTBUF_SIZE 81920
+/** a wav header is always 44 bytes */
 #define WAV_HEADER_LEN 44
+/** always write 16 bit header */
 #define BITS 16
 
-/* derived from oggdec.c of the vorbis-tools-1.0.1 package */
+/**
+ * write a 32 bit unsigned value to a buffer
+ *
+ * \param buf the buffer to write to
+ * \param x the value to write
+ */
 #define WRITE_U32(buf, x) (buf)[0] = (unsigned char)((x) & 0xff);\
 	(buf)[1] = (unsigned char)(((x) >> 8) & 0xff);\
 	(buf)[2] = (unsigned char)(((x) >> 16) & 0xff);\
 	(buf)[3] = (unsigned char)(((x) >> 24) & 0xff);
+
+/**
+ * write a 16 bit unsigned value to a buffer
+ *
+ * \param buf the buffer to write to
+ * \param x the value to write
+ */
 #define WRITE_U16(buf, x) (buf)[0] = (unsigned char)((x) & 0xff);
 
 static void make_wav_header(int channels, int samplerate, struct filter_node *fn)
@@ -100,6 +115,11 @@ static void wav_open(struct filter_node *fn)
 		fn, fn->buf, fn->loaded);
 }
 
+/**
+ * the init function of the wav filter
+ *
+ * \param f struct to initialize
+ */
 void wav_init(struct filter *f)
 {
 	f->convert = wav_convert;