diff --git a/platform/posix/wav_util.h b/platform/posix/wav_util.h
index a9fecb672..a4f3fe2ce 100644
--- a/platform/posix/wav_util.h
+++ b/platform/posix/wav_util.h
@@ -45,7 +45,7 @@
 // return 0 if ok
 
 /**
- * Write Int16 samples (host endianess)
+ * Open singleton wav writer
  * @return 0 if ok
  */
 int wav_writer_open(const char * filepath, int num_channels, int sampling_frequency);
@@ -71,9 +71,24 @@ int wav_writer_write_le_int16(int num_samples, int16_t * data);
 int wav_writer_close(void);
 
 
-// return 0 if ok
+/**
+ * Open singleton war reader
+ * @return 0 if ok
+ */
 int wav_reader_open(const char * filepath);
+/**
+ * Read Int8 samples
+ * @return 0 if ok
+ */
 int wav_reader_read_int8(int num_samples, int8_t * data);
+/**
+ * Read Int16 samples (host endianess)
+ * @return 0 if ok
+ */
 int wav_reader_read_int16(int num_samples, int16_t * data);
+/**
+ * Close war reader
+ * @return 0 if ok
+ */
 int wav_reader_close(void);