cue_parser: add code comments

1 files changed, 21 insertions, 2 deletions

diff --git a/src/cue/cue_parser.c b/src/cue/cue_parser.c
index 898c7b82..4031d6c4 100644
--- a/src/cue/cue_parser.c
+++ b/src/cue/cue_parser.c
@@ -58,8 +58,27 @@ struct cue_parser {
 
 	char *filename;
 
-	struct song *current, *previous, *finished;
-
+	/**
+	 * The song currently being edited.
+	 */
+	struct song *current;
+
+	/**
+	 * The previous song.  It is remembered because its end_time
+	 * will be set to the current song's start time.
+	 */
+	struct song *previous;
+
+	/**
+	 * A song that is completely finished and can be returned to
+	 * the caller via cue_parser_get().
+	 */
+	struct song *finished;
+
+	/**
+	 * Set to true after previous.end_time has been updated to the
+	 * start time of the current song.
+	 */
 	bool last_updated;
 };