From 7ac6213907f3767f2ea0bd726e166cbce80bfa45 Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Wed, 21 May 2025 20:36:52 +0200 Subject: [PATCH] Improve documentation of set_max_chunk_size(). The old text implied that the function could be removed at some point, which is not the case. Remove this part of the documentation and clarify what the function actually does. --- afh_common.c | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/afh_common.c b/afh_common.c index 0f17a67b..11b45c7f 100644 --- a/afh_common.c +++ b/afh_common.c @@ -424,15 +424,14 @@ unsigned afh_get_afhi_txt(int audio_format_num, struct afh_info *afhi, char **re } /** - * Determine the maximal chunk size by investigating the chunk table. + * Determine the maximal chunk size by iterating the chunk table. * * \param afhi Value/result. * - * This function iterates over the chunk table and sets ->max_chunk_size - * accordingly. The function exists only for backward compatibility since as of - * version 0.6.0, para_server stores the maximal chunk size in its database. - * This function is only called if the database value is zero, indicating that - * the file was added by an older server version. + * This function is called by the audio format handlers, for example when a + * new audio file is added to the afs database. The chunk table is determined + * from the given afhi pointer, and the maximal chunk size is returned via + * the ->max_chunk_size member of the same pointer. */ void set_max_chunk_size(struct afh_info *afhi) { -- 2.39.5