[clang] [llvm] Make sanitizer special case list slash-agnostic (PR #149886)

Vitaly Buka via llvm-commits llvm-commits at lists.llvm.org
Tue Oct 7 10:23:12 PDT 2025


================
@@ -196,6 +196,23 @@ tool-specific docs.
     [{cfi-vcall,cfi-icall}]
     fun:*BadCfiCall
 
+
+.. note::
+
+  By default, ``src`` and ``mainfile`` are matched against the filename as seen
+  by LLVM. On Windows, this might involve a mix of forward and backslashes as
+  file separators, and writing patterns to match both variants can be
+  inconvenient.
+  
+  If the special case list file begins with ``#!canonical-paths``, then paths
+  will be canonicalized before patterns are matched against them. This involves
+  stripping any leading dots and slashes, and (on Windows only) converting all
+  backslashes to forward slashes.
+
+  If the file uses both ``#!special-case-list-v1`` and ``#!canonical-paths``,
----------------
vitalybuka wrote:

And I sujjest to not add ``#!special-case-list-v1`` and ``#!canonical-paths`` into this doc at all.

Users should update files ASAP

Good place for this is Beaking Changes in clang release notes 

https://github.com/llvm/llvm-project/pull/149886


More information about the llvm-commits mailing list