X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=mood.c;h=89ad80d956af3b7107f7ae4883619e689d3d2582;hp=d24eac912161f5d51c27ea020c08fccddb2f066a;hb=fd62cf6f3c17ec9f504d3a05be4fd48f969dcb01;hpb=9b565c60fd159e12d255bb18db9dbff066deebea

diff --git a/mood.c b/mood.c
index d24eac91..89ad80d9 100644
--- a/mood.c
+++ b/mood.c
@@ -890,6 +890,17 @@ static int reload_current_mood(void)
 	return ret;
 }
 
+/**
+ * Notification callback for the moods table.
+ *
+ * \param event Type of the event just occurred.
+ * \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.
+ */
 int moods_event_handler(enum afs_events event, __a_unused struct para_buffer *pb,
 		void *data)
 {
@@ -926,4 +937,3 @@ int moods_event_handler(enum afs_events event, __a_unused struct para_buffer *pb
 		return 1;
 	}
 }
-