X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=bitstream.c;h=ddad67bb177211b3909f88d3be9dcb3d5c381238;hp=f0f6012c84a1e4df95b7293f4b1c1459f937e275;hb=29921a5e29530801697ce4e4773738404efcbf57;hpb=5f440e02ddea20370917c67cc5ea71cedbbfabbc

diff --git a/bitstream.c b/bitstream.c
index f0f6012c..ddad67bb 100644
--- a/bitstream.c
+++ b/bitstream.c
@@ -27,6 +27,7 @@
 #include "wma.h"
 #include "bitstream.h"
 
+/** Read an 8, 16, or 32 bit entity from a VLC table. */
 #define GET_DATA(v, table, i, size) \
 {\
 	const uint8_t *ptr = (const uint8_t *)table + i * size; \
@@ -160,6 +161,14 @@ void init_vlc(struct vlc *vlc, int nb_bits, int nb_codes, const void *bits,
 	build_table(vlc, nb_bits, nb_codes, bits, codes, codes_size, 0, 0);
 }
 
+/**
+ * Deallocate all resources of a VLC table.
+ *
+ * \param vlc Pointer to an initialized vlc structure.
+ *
+ * The table given by \a vlc must have been initialized earlier via \ref
+ * init_vlc().
+ */
 void free_vlc(struct vlc *vlc)
 {
 	freep(&vlc->table);
@@ -203,5 +212,5 @@ int get_vlc(struct getbit_context *gbc, VLC_TYPE(*table)[2], int bits,
 		}
 	}
 	skip_bits(gbc, n);
-	return code;
+	return code >= 0? code : -E_VLC;
 }