From d3f72d102325ff8ad1f41087f9327ae9fa228b6b Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@duempel.org>
Date: Sat, 12 Apr 2008 04:08:35 +0000
Subject: some documentation about OutputBuffer

git-svn-id: https://svn.musicpd.org/mpd/trunk@7245 09075e82-0dd4-0310-85a5-a0d7c8717e4f
---
 src/outputBuffer.h | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/outputBuffer.h b/src/outputBuffer.h
index 6ab171879..4d480e08a 100644
--- a/src/outputBuffer.h
+++ b/src/outputBuffer.h
@@ -29,13 +29,22 @@
 #define OUTPUT_BUFFER_DC_STOP   -1
 #define OUTPUT_BUFFER_DC_SEEK   -2
 
+/**
+ * A ring set of buffers where the decoder appends data after the end,
+ * and the player consumes data from the beginning.
+ */
 typedef struct _OutputBuffer {
 	char *volatile chunks;
 	mpd_uint16 *volatile chunkSize;
 	mpd_uint16 *volatile bitRate;
 	float *volatile times;
+
+	/** the index of the first decoded chunk */
 	mpd_uint16 volatile begin;
+
+	/** the index after the last decoded chunk */
 	mpd_uint16 volatile end;
+
 	AudioFormat audioFormat;
 	ConvState convState;
 } OutputBuffer;
-- 
cgit v1.2.3