From b2456e1c934926bcf4f0a1ba8bdbfeb9423c28e5 Mon Sep 17 00:00:00 2001
From: Robert Mongold <rtmongold@gmail.com>
Date: Fri, 27 Mar 2026 01:15:31 -0400
Subject: [PATCH 1/2] Clarify MatchCasing does not affect directory path
 resolution

---
 xml/System.IO/EnumerationOptions.xml | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/xml/System.IO/EnumerationOptions.xml b/xml/System.IO/EnumerationOptions.xml
index e70529c90c7..af161aa3c76 100644
--- a/xml/System.IO/EnumerationOptions.xml
+++ b/xml/System.IO/EnumerationOptions.xml
@@ -240,11 +240,22 @@ The suggested buffer size will not be used if it has no meaning for the native A
 
 ## Remarks
 
-For APIs that allow specifying a match expression, this property allows you to specify the case matching behavior.
-The default is to match platform defaults, which are gleaned from the case sensitivity of the temporary folder.
+This property controls **case matching for file name patterns only**.  
+It **does not affect directory path resolution**. On case-sensitive file systems
+(such as Linux and macOS), directory paths must match the exact casing regardless of this setting.
 
- ]]></format>
-        </remarks>
+The default is to match the platform defaults, which are based on the case sensitivity of the filesystem.
+
+          ]]></format>
+	</remarks>
+	<example>
+          <format type="text/markdown"><![CDATA[
+Directory.GetFiles("/tmp/data", "*.TXT",
+    new EnumerationOptions { MatchCasing = MatchCasing.CaseInsensitive });
+
+> Matches file names case-insensitively, but `/tmp/data` directory path must still match exact casing on Linux/macOS.
+          ]]></format>
+        </example>
       </Docs>
     </Member>
     <Member MemberName="MatchType">

From f8573a5b901aed031c1b9dce173ca7a30801150e Mon Sep 17 00:00:00 2001
From: Robert Mongold <rtmongold@gmail.com>
Date: Fri, 27 Mar 2026 01:25:45 -0400
Subject: [PATCH 2/2] Fix XML formatting and update example for casing

---
 xml/System.IO/EnumerationOptions.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/xml/System.IO/EnumerationOptions.xml b/xml/System.IO/EnumerationOptions.xml
index af161aa3c76..156a9063227 100644
--- a/xml/System.IO/EnumerationOptions.xml
+++ b/xml/System.IO/EnumerationOptions.xml
@@ -246,15 +246,15 @@ It **does not affect directory path resolution**. On case-sensitive file systems
 
 The default is to match the platform defaults, which are based on the case sensitivity of the filesystem.
 
-          ]]></format>
-	</remarks>
-	<example>
+ ]]></format>
+	    </remarks>
+	    <example>
           <format type="text/markdown"><![CDATA[
 Directory.GetFiles("/tmp/data", "*.TXT",
-    new EnumerationOptions { MatchCasing = MatchCasing.CaseInsensitive });
+new EnumerationOptions { MatchCasing = MatchCasing.CaseInsensitive });
 
 > Matches file names case-insensitively, but `/tmp/data` directory path must still match exact casing on Linux/macOS.
-          ]]></format>
+ ]]></format>
         </example>
       </Docs>
     </Member>