diff --git a/components/freertos/CMakeLists.txt b/components/freertos/CMakeLists.txt
index 2c93a4016b..17e6749d1e 100644
--- a/components/freertos/CMakeLists.txt
+++ b/components/freertos/CMakeLists.txt
@@ -103,7 +103,7 @@ list(APPEND srcs
 
 if(kernel_impl STREQUAL "FreeRTOS-Kernel")
     list(APPEND srcs
-        "esp_additions/freertos_v8_compat.c")
+        "esp_additions/freertos_compatibility.c")
 endif()
 
 if(arch STREQUAL "linux")
diff --git a/components/freertos/esp_additions/freertos_v8_compat.c b/components/freertos/esp_additions/freertos_compatibility.c
similarity index 59%
rename from components/freertos/esp_additions/freertos_v8_compat.c
rename to components/freertos/esp_additions/freertos_compatibility.c
index eda3675ee6..009fde8b8e 100644
--- a/components/freertos/esp_additions/freertos_v8_compat.c
+++ b/components/freertos/esp_additions/freertos_compatibility.c
@@ -4,11 +4,20 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/*
+ * FreeRTOS has changed some functions in to macros (and vice-versa) over multiple
+ * releases. This is not a breaking API change for source code, but may cause issues
+ * for pre-compiled libraries that call these removed APIs.
+ *
+ * This file maintains these legacy APIs until the next ESP-IDF major release.
+ *
+ * Todo: Clean up for ESP-IDF v6.0 (IDF-8144)
+*/
+
 #include "FreeRTOS.h"
 #include "queue.h"
 #include "semphr.h"
 
-/* This API is kept for backward ABI compatibility with prebuilt libraries against FreeRTOS v8/v9 in ESP-IDF */
 BaseType_t xQueueGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, const BaseType_t xPeek )
 {
 	if ( xPeek == pdTRUE )