From 3fea1f7c74dedefcf0b76eafbca664d8cc2d3a76 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Mon, 17 Aug 2026 08:19:10 -0500
Subject: [PATCH 1/2] Document XmlPullParserFactory members

Refs #250

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml b/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml
index 90e653a53..4a121b308 100644
--- a/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml
+++ b/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml
@@ -117,7 +117,7 @@
       </ReturnValue>
       <Docs>
         <summary>Unused, but we have to keep it because it's public API.</summary>
-        <value>To be added.</value>
+        <value>The unused class-names location retained for API compatibility.</value>
         <remarks>
           <para>Unused, but we have to keep it because it's public API.</para>
           <para>
@@ -156,7 +156,7 @@
       <Docs>
         <summary>
         </summary>
-        <value>To be added.</value>
+        <value>The feature settings applied when creating an XML pull parser.</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>
@@ -325,7 +325,7 @@
       <Docs>
         <summary>Creates a new instance of a PullParserFactory that can be used
             to create XML pull parsers.</summary>
-        <returns>To be added.</returns>
+        <returns>A factory that creates Android's built-in XML pull parser and serializer implementations.</returns>
         <remarks>
           <para>Creates a new instance of a PullParserFactory that can be used
             to create XML pull parsers. The factory will always return instances
@@ -369,11 +369,11 @@
         <Parameter Name="unused2" Type="Java.Lang.Class" />
       </Parameters>
       <Docs>
-        <param name="unused">To be added.</param>
-        <param name="unused2">To be added.</param>
+        <param name="unused">Unused.</param>
+        <param name="unused2">Unused.</param>
         <summary>Creates a factory that always returns instances of Android's built-in
             <c>XmlPullParser</c> and <c>XmlSerializer</c> implementation.</summary>
-        <returns>To be added.</returns>
+        <returns>A factory that creates Android's built-in XML pull parser and serializer implementations.</returns>
         <remarks>
           <para>Creates a factory that always returns instances of Android's built-in
             <c>XmlPullParser</c> and <c>XmlSerializer</c> implementation. This
@@ -501,7 +501,7 @@
       <Docs>
         <summary>
         </summary>
-        <value>To be added.</value>
+        <value>The classes used to create XML pull parser instances.</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>
@@ -562,7 +562,7 @@
       <Docs>
         <summary>
         </summary>
-        <value>To be added.</value>
+        <value>The classes used to create XML serializer instances.</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>

From 30b4985945fb83df716d2a3651bf548e61b78b52 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Mon, 17 Aug 2026 08:30:13 -0500
Subject: [PATCH 2/2] Correct XmlPullParserFactory terminology

Refs #250

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml b/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml
index 4a121b308..1ed141519 100644
--- a/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml
+++ b/docs/xml/Org.XmlPull.V1/XmlPullParserFactory.xml
@@ -323,11 +323,11 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Creates a new instance of a PullParserFactory that can be used
+        <summary>Creates a new instance of an XmlPullParserFactory that can be used
             to create XML pull parsers.</summary>
         <returns>A factory that creates Android's built-in XML pull parser and serializer implementations.</returns>
         <remarks>
-          <para>Creates a new instance of a PullParserFactory that can be used
+          <para>Creates a new instance of an XmlPullParserFactory that can be used
             to create XML pull parsers. The factory will always return instances
             of Android's built-in <c>XmlPullParser</c> and <c>XmlSerializer</c>.</para>
           <para>