From b147df36cc82f06197bbf597f71dfaed69120dd1 Mon Sep 17 00:00:00 2001
From: "Marco Antonio J. Costa" <marco.antonio.costa@gmail.com>
Date: Fri, 21 Aug 2026 00:28:42 -0300
Subject: [PATCH] clarify comment and exit condition because of RakNet+ASAN

---
 cmake/AddressSanitizer.cmake | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/cmake/AddressSanitizer.cmake b/cmake/AddressSanitizer.cmake
index 594c5b847..482c7ace6 100644
--- a/cmake/AddressSanitizer.cmake
+++ b/cmake/AddressSanitizer.cmake
@@ -14,7 +14,12 @@ set(_asan "$<AND:$<BOOL:${ADDRESS_SANITIZER}>,$<OR:$<CONFIG:Debug>,$<CONFIG:RelW
 if(ADDRESS_SANITIZER)
   message(STATUS "AddressSanitizer ENABLED for Debug and RelWithDebInfo (first-party code only)")
   message(STATUS "  Bink stubbed into the exe; no binkw32.dll import, so the asan exe runs from gamedir untouched")
-  # keep MSVC-STL container annotations uniform across un-instrumented TUs
+  # Disable STL container-overflow annotations (_DISABLE_STL_ANNOTATION).
+  # RakNet ships prebuilt and un-annotated; leaving annotations on makes the
+  # linker reject the mix (LNK2038: mismatch detected for 'annotate_vector').
+  # When every vendored C++ lib is built from our source, drop this and add
+  # _ANNOTATE_STL to them instead — that restores detection without needing
+  # to instrument their code.
   add_compile_definitions("$<${_asan}:_DISABLE_STL_ANNOTATION>")
   # retail binkw32.dll cannot load in an asan process (image base 0x30000000 is
   # the 32-bit shadow). __RADINEXE__ makes bink.h declare the Bink functions as