From: Andre Noll <maan@tuebingen.mpg.de>
Date: Wed, 11 Jun 2025 17:11:52 +0000 (+0200)
Subject: afs
X-Git-Url: https://git.tuebingen.mpg.de/?a=commitdiff_plain;h=ddd0ea250f131fd538e82d9e98516095f9299bef;p=paraslash.git

afs
---

diff --git a/afs.h b/afs.h
index 7129af88..ee48e06f 100644
--- a/afs.h
+++ b/afs.h
@@ -1,6 +1,19 @@
 /* Copyright (C) 2007 Andre Noll <maan@tuebingen.mpg.de>, see file COPYING. */
 
-/** \file afs.h Exported symbols of the audio file selector. */
+/** \file afs.h The the audio file selector.
+ *
+ * The code of the audio file selector (afs) is distributed across several
+ * source files, which results in a rather large set of non-static functions
+ * and variables with intricate inter-dependencies.
+ *
+ * The central file is \ref afs.c, which contains the afs init and shutdown
+ * functions and the table-independent code. Other source files whose object
+ * files become part of afs are \ref attribute.c, \ref aft.c, \ref score.c,
+ * \ref mood.c, \ref playlist.c and \ref blob.c.
+ *
+ * There is only this single header file for the afs API. All non-static
+ * symbols of the source files listed above are declared here.
+ */
 
 /** Audio file selector data stored in the audio file table. */
 struct afs_info {