X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=mood.c;h=bcc9bc57d1a37520ca71f93d5d93a7fe1e2e2927;hb=be5daec66f163725489f42d512659a8af5c3fd59;hp=fbc22297fd0df3a2d1fb5b7927fde5b1a7825315;hpb=c88ccb7d91ea4baab78e24922d5c1d0cbaf6dcce;p=paraslash.git

diff --git a/mood.c b/mood.c
index fbc22297..bcc9bc57 100644
--- a/mood.c
+++ b/mood.c
@@ -138,7 +138,7 @@ static void destroy_mood(struct mood *m)
 
 static struct mood *alloc_new_mood(const char *name)
 {
-	struct mood *m = para_calloc(sizeof(struct mood));
+	struct mood *m = zalloc(sizeof(struct mood));
 	if (name)
 		m->name = para_strdup(name);
 	return m;
@@ -363,8 +363,8 @@ static int add_if_admissible(struct osl_row *aft_row, void *data)
 	if (statistics.num >= aa->size) {
 		aa->size *= 2;
 		aa->size += 100;
-		aa->array = para_realloc(aa->array,
-			aa->size * sizeof(struct osl_row *));
+		aa->array = arr_realloc(aa->array, aa->size,
+			sizeof(struct osl_row *));
 	}
 	aa->array[statistics.num] = aft_row;
 	return add_afs_statistics(aft_row);
@@ -607,8 +607,7 @@ static void compute_correction_factors(int64_t sse)
  *
  * If there is already an open mood, it will be closed first.
  *
- * \return Positive on success, negative on errors. Loading the dummy mood
- * always succeeds.
+ * \return Positive on success, negative on errors.
  *
  * \sa struct \ref afs_info::last_played, \ref mp_eval_row().
  */
@@ -716,9 +715,17 @@ static int reload_current_mood(void)
  * \param pb Unused.
  * \param data Its type depends on the event.
  *
- * This function performs actions required due to the occurrence of the given
- * event. Possible actions include reload of the current mood and update of the
- * score of an audio file.
+ * This function updates the score table according to the event that has
+ * occurred. Two actions are possible: (a) reload the current mood, or (b)
+ * add/remove/update the row of the score table which corresponds to the audio
+ * file that has been modified or whose afs info has been changed. It depends
+ * on the type of the event which action (if any) is performed.
+ *
+ * The callbacks of command handlers such as com_add() or com_touch() which
+ * modify the audio file table call this function. The virtual streaming system
+ * also calls this after it has updated the afs info of the file it is about to
+ * stream (the one with the highest score). If the file stays admissible, its
+ * score is recomputed so that a different file is picked next time.
  *
  * \return Standard.
  */