From: Andre Noll <maan@tuebingen.mpg.de>
Date: Wed, 9 Mar 2022 21:43:26 +0000 (+0100)
Subject: afs.c: Improve documentation of score table.
X-Git-Tag: v0.7.1~28
X-Git-Url: http://git.tuebingen.mpg.de/?a=commitdiff_plain;h=03b4e39aad5a87e70306127157c65f87ac6498d9;p=paraslash.git

afs.c: Improve documentation of score table.

The text focussed on implementation details rather than describing the
purpose of the table. It was also slightly incorrect because playlists
also use the score tables, albeit in a much simpler way and without
"Gaussian normal distributions".
---

diff --git a/afs.c b/afs.c
index 6d6e67e8..c0632c24 100644
--- a/afs.c
+++ b/afs.c
@@ -39,11 +39,10 @@ enum afs_table_num {
 	TBLNUM_AUDIO_FILES,
 	/** The table for the paraslash attributes. See \ref attribute.c. */
 	TBLNUM_ATTRIBUTES,
-	/**
-	 * Paraslash's scoring system is based on Gaussian normal
-	 * distributions, and the relevant data is stored in the rbtrees of an
-	 * osl table containing only volatile columns. See \ref score.c for
-	 * details.
+	/*
+	 * Moods and playlists organize the current set of admissible files in
+	 * an osl table which contains only volatile columns. Each row consists
+	 * of a pointer to an audio file and the score value of this file.
 	 */
 	TBLNUM_SCORES,
 	/**