playlist: added source comments

The playlist.c source is currently quite hard to understand. I have managed to wrap my head around it, and this patch attempts to explain it to the next guy.

playlist: added source comments
cf3a9ef0 · Max Kellermann · b5abc023 · cf3a9ef0 · cf3a9ef0
Commit cf3a9ef0 authored Jan 23, 2009 by Max Kellermann
Expand all Hide whitespace changes
Inline Side-by-side

Showing with 4 additions and 1 deletion

playlist.c src/playlist.c +0 -0

playlist.h src/playlist.h +4 -1

No files found.
--- a/src/playlist.c
+++ b/src/playlist.c
--- a/src/playlist.h
+++ b/src/playlist.h
@@ -64,7 +64,10 @@ typedef struct _Playlist {

 	/**
 	 * The "next" song to be played, when the current one
-	 * finishes.
+	 * finishes.  The decoder thread may start decoding and
+	 * buffering it, while the "current" song is still playing.
+	 *
+	 * This variable is only valid if #playing is true.
 	 */
 	int queued;
 } Playlist;