From 41591eaf2e690416897ce3168e888d85ebf93333 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 14 Aug 2026 03:12:11 -0500
Subject: [PATCH 1/2] Document TextUtils string splitter iteration

Refs #223

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../Android.Text/TextUtils+SimpleStringSplitter.xml    | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml b/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml
index d86bc2730..5744140ec 100644
--- a/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml
+++ b/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml
@@ -146,7 +146,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns true if there is at least one more element, false otherwise.</summary>
-        <value>To be added.</value>
+        <value><see langword="true" /> if the iteration has more elements; otherwise, <see langword="false" />.</value>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -178,7 +178,7 @@
       <Parameters />
       <Docs>
         <summary>Returns an <see cref="T:Java.Util.IIterator" /> for the elements in this object.</summary>
-        <returns>To be added.</returns>
+        <returns>An iterator over the elements in this object.</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -203,8 +203,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns the next element in the iteration.</summary>
+        <returns>The next element in the iteration.</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -266,7 +266,7 @@
       <Parameters />
       <Docs>
         <summary>Returns the next object and advances the iterator.</summary>
-        <returns>To be added.</returns>
+        <returns>The next element in the iteration.</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>

From e001ef68d92e0ef109c39b8df2e198b7a5ed325c Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 14 Aug 2026 03:23:19 -0500
Subject: [PATCH 2/2] Clarify string splitter iterator identity

Refs #223

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml b/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml
index 5744140ec..427be1ee5 100644
--- a/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml
+++ b/docs/xml/Android.Text/TextUtils+SimpleStringSplitter.xml
@@ -178,7 +178,7 @@
       <Parameters />
       <Docs>
         <summary>Returns an <see cref="T:Java.Util.IIterator" /> for the elements in this object.</summary>
-        <returns>An iterator over the elements in this object.</returns>
+        <returns>This splitter, which serves as its own iterator.</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>