From bb6c95ec2fd2940baddc42784a6194cd7d402410 Mon Sep 17 00:00:00 2001
From: joegoldman2 <147369450+joegoldman2@users.noreply.github.com>
Date: Wed, 11 Sep 2024 17:30:59 +0000
Subject: [PATCH] Clarify XML comments for Utf8Parser.TryParse to reflect case
 insensitivity (#103861)

* Clarify XML comments for Utf8Parser.TryParse to reflect case insensitivity

* Clarify doc

* Update doc

* Update src/libraries/System.Private.CoreLib/src/System/Buffers/Text/Utf8Parser/Utf8Parser.Boolean.cs

Co-authored-by: Tanner Gooding <tagoo@outlook.com>

* Update src/libraries/System.Private.CoreLib/src/System/Buffers/Text/Utf8Parser/Utf8Parser.Boolean.cs

---------

Co-authored-by: joegoldman2 <147369450+joegoldman@users.noreply.github.com>
Co-authored-by: Tanner Gooding <tagoo@outlook.com>
---
 .../System/Buffers/Text/Utf8Parser/Utf8Parser.Boolean.cs  | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/src/libraries/System.Private.CoreLib/src/System/Buffers/Text/Utf8Parser/Utf8Parser.Boolean.cs b/src/libraries/System.Private.CoreLib/src/System/Buffers/Text/Utf8Parser/Utf8Parser.Boolean.cs
index b19cee4e43ecc0..da378c06b7d70f 100644
--- a/src/libraries/System.Private.CoreLib/src/System/Buffers/Text/Utf8Parser/Utf8Parser.Boolean.cs
+++ b/src/libraries/System.Private.CoreLib/src/System/Buffers/Text/Utf8Parser/Utf8Parser.Boolean.cs
@@ -12,16 +12,14 @@ public static partial class Utf8Parser
         /// </summary>
         /// <param name="source">The Utf8 string to parse</param>
         /// <param name="value">Receives the parsed value</param>
-        /// <param name="bytesConsumed">On a successful parse, receives the length in bytes of the substring that was parsed </param>
-        /// <param name="standardFormat">Expected format of the Utf8 string</param>
+        /// <param name="bytesConsumed">On a successful parse, receives the length in bytes of the substring that was parsed.</param>
+        /// <param name="standardFormat">Expected format of the Utf8 string. Supported formats are <c>'G'</c>, <c>'l'</c>, and <c>default</c>.</param>
         /// <returns>
         /// true for success. "bytesConsumed" contains the length in bytes of the substring that was parsed.
         /// false if the string was not syntactically valid or an overflow or underflow occurred. "bytesConsumed" is set to 0.
         /// </returns>
         /// <remarks>
-        /// Formats supported:
-        ///     G (default)   True/False
-        ///     l             true/false
+        /// The parsing is case insensitive. The format parameter is validated to ensure it is supported; however, all supported formats are treated identically.
         /// </remarks>
         /// <exceptions>
         /// <cref>System.FormatException</cref> if the format is not valid for this data type.