From e796c4774614e44189641e45c49bcb811c88c45c Mon Sep 17 00:00:00 2001
From: joegoldman2 <147369450+joegoldman2@users.noreply.github.com>
Date: Wed, 11 Sep 2024 17:48:58 +0000
Subject: [PATCH] Clarify XML comments for Utf8Parser.TryParse to reflect case
 insensitivity

---
 xml/System.Buffers.Text/Utf8Parser.xml | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/xml/System.Buffers.Text/Utf8Parser.xml b/xml/System.Buffers.Text/Utf8Parser.xml
index 95a709ca91a..cfde16b3907 100644
--- a/xml/System.Buffers.Text/Utf8Parser.xml
+++ b/xml/System.Buffers.Text/Utf8Parser.xml
@@ -71,21 +71,16 @@
       </Parameters>
       <Docs>
         <param name="source">The Utf8 string to parse.</param>
-        <param name="value">When the method returns, contains the value parsed from <paramref name="source" />, if the parsing operation succeeded. </param>
+        <param name="value">When the method returns, contains the value parsed from <paramref name="source" />, if the parsing operation succeeded.</param>
         <param name="bytesConsumed">If the parsing operation was successful, contains the length in bytes of the parsed substring when the method returns. If the method fails, <paramref name="bytesConsumed" /> is set to 0.</param>
-        <param name="standardFormat">The expected format of the Utf8 string.</param>
+        <param name="standardFormat">The expected format of the Utf8 string. Supported formats are <c>'G'</c>, <c>'l'</c>, and <c>default</c>.</param>
         <summary>Parses a <see cref="T:System.Boolean" /> at the start of a Utf8 string.</summary>
         <returns>
           <see langword="true" /> for success; <see langword="false" /> if the string was not syntactically valid or an overflow or underflow occurred.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
-Formats supported: 
-
-|Format string|Example expected format|
-|--|--|
-|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.
 
 ]]></format>
         </remarks>