From c27c7f0f007188181c7839ab59f31cd99c935ab1 Mon Sep 17 00:00:00 2001
From: Rob Hague <rh@johnstreetcapital.com>
Date: Fri, 25 Jul 2025 15:48:48 +0100
Subject: [PATCH 1/2] Update docs on Rune.DecodeFromUtf8

This was updated in https://github.com/dotnet/runtime/pull/328/
---
 xml/System.Text/Rune.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Text/Rune.xml b/xml/System.Text/Rune.xml
index 10acdb37994..1b56091fe14 100644
--- a/xml/System.Text/Rune.xml
+++ b/xml/System.Text/Rune.xml
@@ -327,7 +327,7 @@ The general convention is to call this method in a loop, slicing the `source` bu
         <returns>
           <see cref="F:System.Buffers.OperationStatus.Done" /> if the source buffer begins with a valid UTF-8 encoded scalar value. <paramref name="result" /> then contains the decoded <see cref="T:System.Text.Rune" />, and <paramref name="bytesConsumed" /> contains the number of <see cref="T:System.Byte" /> values used in the input buffer to encode the <see cref="T:System.Text.Rune" />.
 
-<see cref="F:System.Buffers.OperationStatus.NeedMoreData" /> if the source buffer is empty or contains only a standalone UTF-8 high surrogate character. <paramref name="result" /> then contains <see cref="P:System.Text.Rune.ReplacementChar" />, and <paramref name="bytesConsumed" /> contains the length of the input buffer.
+<see cref="F:System.Buffers.OperationStatus.NeedMoreData" /> if the source buffer is empty or contains only a partial UTF-8 subsequence. <paramref name="result" /> then contains <see cref="P:System.Text.Rune.ReplacementChar" />, and <paramref name="bytesConsumed" /> contains the length of the input buffer.
 
 <see cref="F:System.Buffers.OperationStatus.InvalidData" /> if the source buffer begins with an ill-formed UTF-8 encoded scalar value. <paramref name="result" /> then contains <see cref="P:System.Text.Rune.ReplacementChar" />, and <paramref name="bytesConsumed" /> contains the number of <see cref="T:System.Byte" /> values used in the input buffer to encode the ill-formed sequence.
           .</returns>

From c9b0cc19e313b07942a3d739edc703bb8cf79956 Mon Sep 17 00:00:00 2001
From: Rob Hague <rh@johnstreetcapital.com>
Date: Fri, 25 Jul 2025 16:03:27 +0100
Subject: [PATCH 2/2] also DecodeLastFromUtf8

---
 xml/System.Text/Rune.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Text/Rune.xml b/xml/System.Text/Rune.xml
index 1b56091fe14..610e69dc408 100644
--- a/xml/System.Text/Rune.xml
+++ b/xml/System.Text/Rune.xml
@@ -427,7 +427,7 @@ This method is very similar to <xref:System.Text.Rune.DecodeFromUtf16(System.Rea
         <returns>
           <see cref="F:System.Buffers.OperationStatus.Done" /> if the source buffer ends with a valid UTF-8 encoded scalar value. <paramref name="value" /> then contains the decoded <see cref="T:System.Text.Rune" />, and <paramref name="bytesConsumed" /> contains the number of <see cref="T:System.Byte" /> values used in the input buffer to encode the <see cref="T:System.Text.Rune" />.
 
-<see cref="F:System.Buffers.OperationStatus.NeedMoreData" /> if the source buffer is empty or contains only a standalone UTF-8 high surrogate character. <paramref name="value" /> then contains <see cref="P:System.Text.Rune.ReplacementChar" />, and <paramref name="bytesConsumed" /> contains the length of the input buffer.
+<see cref="F:System.Buffers.OperationStatus.NeedMoreData" /> if the source buffer is empty or contains only a partial UTF-8 subsequence. <paramref name="value" /> then contains <see cref="P:System.Text.Rune.ReplacementChar" />, and <paramref name="bytesConsumed" /> contains the length of the input buffer.
 
 <see cref="F:System.Buffers.OperationStatus.InvalidData" /> if the source buffer ends with an ill-formed UTF-8 encoded scalar value. <paramref name="value" /> then contains <see cref="P:System.Text.Rune.ReplacementChar" />, and <paramref name="bytesConsumed" /> contains the number of <see cref="T:System.Byte" /> values used in the input buffer to encode the ill-formed sequence.
         </returns>