From a45184b0f2c815d9ef77c784115d5295f1654543 Mon Sep 17 00:00:00 2001
From: Ladi Prosek <laprosek@microsoft.com>
Date: Tue, 23 Feb 2021 13:34:54 +0100
Subject: [PATCH] PR feedback (Mihai): More explicit comment on
 DirectoryPattern

---
 src/Shared/FileMatcher.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Shared/FileMatcher.cs b/src/Shared/FileMatcher.cs
index 400de67a5d3..f919db321d4 100644
--- a/src/Shared/FileMatcher.cs
+++ b/src/Shared/FileMatcher.cs
@@ -796,7 +796,9 @@ bool needsRecursion
             public string Filespec { get; }
             /// <summary>
             /// Holds the directory pattern for globs like **/{pattern}/**, i.e. when we're looking for a matching directory name
-            /// regardless of where on the path it is.
+            /// regardless of where on the path it is. This field is used only if the wildcard directory part has this shape. In
+            /// other cases such as **/{pattern1}/**/{pattern2}/**, we don't use this optimization and instead rely on
+            /// <see cref="RegexFileMatch"/> to test if a file path matches the glob or not.
             /// </summary>
             public string DirectoryPattern { get; }
             /// <summary>