From f03a012087868cbfc56a139e80505fcc86f51e4c Mon Sep 17 00:00:00 2001
From: Tim Angus <tim@ngus.net>
Date: Tue, 12 Aug 2025 11:44:59 +0100
Subject: [PATCH] Document reasons for contents of COMMON_LIBRARIES

---
 cmake/platforms/unix.cmake    | 5 ++++-
 cmake/platforms/windows.cmake | 6 +++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/cmake/platforms/unix.cmake b/cmake/platforms/unix.cmake
index beb2fa28..da4b92f7 100644
--- a/cmake/platforms/unix.cmake
+++ b/cmake/platforms/unix.cmake
@@ -16,7 +16,10 @@ if(USE_HTTP)
     list(APPEND CLIENT_PLATFORM_SOURCES ${SOURCE_DIR}/client/cl_http_curl.c)
 endif()
 
-list(APPEND COMMON_LIBRARIES dl m)
+list(APPEND COMMON_LIBRARIES
+    dl  # Dynamic loader
+    m   # Math library
+)
 
 list(APPEND CLIENT_DEFINITIONS USE_ICON)
 list(APPEND RENDERER_DEFINITIONS USE_ICON)
diff --git a/cmake/platforms/windows.cmake b/cmake/platforms/windows.cmake
index 15de089d..30178fb3 100644
--- a/cmake/platforms/windows.cmake
+++ b/cmake/platforms/windows.cmake
@@ -15,7 +15,11 @@ if(USE_HTTP)
     list(APPEND CLIENT_LIBRARIES wininet)
 endif()
 
-list(APPEND COMMON_LIBRARIES ws2_32 winmm psapi)
+list(APPEND COMMON_LIBRARIES
+    ws2_32 # Windows Sockets 2
+    winmm  # timeBeginPeriod/timeEndPeriod
+    psapi  # EnumProcesses
+)
 
 if(MINGW)
     list(APPEND COMMON_LIBRARIES mingw32)