/**
* Assign scores according to a mood_method.
*
- * Each mood_method has its own mood_score_function. The first parameter passed
- * to that function is a pointer to a row of the audio file table. It
- * determines the audio file for which a score is to be assigned. The second
- * argument depends on the mood method this function is used for. It usually is
- * the argument given at the end of a mood line.
+ * Each mood_method has its own mood_score_function. The first three parameters
+ * passed to that function are informations about the audio file whose score is
+ * to be computed. The data argument depends on the mood method this function
+ * is used for. It usually is the argument given at the end of a mood line.
*
* Mood score functions must return values between -100 and +100 inclusively.
* Boolean score functions should always return either -100 or +100.