From e9366b9602a320c46124afa5ab2c35ea5e86f953 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sun, 16 Aug 2026 21:27:50 -0500
Subject: [PATCH 1/2] Document MBMS download request metadata

Refs #245

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../xml/Android.Telephony.Mbms/DownloadRequest.xml | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml b/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml
index e4b0e0291..66d695cd4 100644
--- a/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml
+++ b/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml
@@ -143,7 +143,7 @@
         <ReturnType>Android.Net.Uri</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The destination <c>Uri</c> of the downloaded file.</summary>
         <value>The destination <c>Uri</c> of the downloaded file.</value>
         <remarks>
           <para>
@@ -183,7 +183,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The ID of the file service to download from.</summary>
         <value>The ID of the file service to download from.</value>
         <remarks>
           <para>
@@ -261,7 +261,8 @@
       <Docs>
         <summary>Maximum permissible length for the app's destination path, when serialized via
             <c>Uri#toString()</c>.</summary>
-        <value>To be added.</value>
+        <value>Maximum permissible length for the app's destination path, when serialized via
+            <c>Uri#toString()</c>.</value>
         <remarks>
           <para>Maximum permissible length for the app's destination path, when serialized via
             <c>Uri#toString()</c>.</para>
@@ -304,7 +305,8 @@
       <Docs>
         <summary>Maximum permissible length for the app's download-completion intent, when serialized via
             <c>Intent#toUri(int)</c>.</summary>
-        <value>To be added.</value>
+        <value>Maximum permissible length for the app's download-completion intent, when serialized via
+            <c>Intent#toUri(int)</c>.</value>
         <remarks>
           <para>Maximum permissible length for the app's download-completion intent, when serialized via
             <c>Intent#toUri(int)</c>.</para>
@@ -345,7 +347,7 @@
         <ReturnType>Android.Net.Uri</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The source URI to download from.</summary>
         <value>The source URI to download from</value>
         <remarks>
           <para>
@@ -385,7 +387,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The subscription ID on which to perform MBMS operations.</summary>
         <value>The subscription ID on which to perform MBMS operations.</value>
         <remarks>
           <para>

From 47160d51c410e24ba6f7491704e9c36c03394537 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sun, 16 Aug 2026 21:38:44 -0500
Subject: [PATCH 2/2] Correct MBMS request size limits

Refs #245

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../DownloadRequest.xml                       | 28 +++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml b/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml
index 66d695cd4..5aad01e0f 100644
--- a/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml
+++ b/docs/xml/Android.Telephony.Mbms/DownloadRequest.xml
@@ -259,13 +259,13 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Maximum permissible length for the app's destination path, when serialized via
-            <c>Uri#toString()</c>.</summary>
-        <value>Maximum permissible length for the app's destination path, when serialized via
-            <c>Uri#toString()</c>.</value>
+        <summary>Maximum permissible length for the app's download-completion intent, when serialized via
+            <c>Intent#toUri(int)</c>.</summary>
+        <value>Maximum permissible length for the app's download-completion intent, when serialized via
+            <c>Intent#toUri(int)</c>.</value>
         <remarks>
-          <para>Maximum permissible length for the app's destination path, when serialized via
-            <c>Uri#toString()</c>.</para>
+          <para>Maximum permissible length for the app's download-completion intent, when serialized via
+            <c>Intent#toUri(int)</c>.</para>
           <para>
             <format type="text/html">
               <a href="https://developer.android.com/reference/android/telephony/mbms/DownloadRequest#getMaxAppIntentSize()" title="Reference documentation">Java documentation for <code>android.telephony.mbms.DownloadRequest.getMaxAppIntentSize()</code>.</a>
@@ -303,13 +303,13 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Maximum permissible length for the app's download-completion intent, when serialized via
-            <c>Intent#toUri(int)</c>.</summary>
-        <value>Maximum permissible length for the app's download-completion intent, when serialized via
-            <c>Intent#toUri(int)</c>.</value>
+        <summary>Maximum permissible length for the app's destination path, when serialized via
+            <c>Uri#toString()</c>.</summary>
+        <value>Maximum permissible length for the app's destination path, when serialized via
+            <c>Uri#toString()</c>.</value>
         <remarks>
-          <para>Maximum permissible length for the app's download-completion intent, when serialized via
-            <c>Intent#toUri(int)</c>.</para>
+          <para>Maximum permissible length for the app's destination path, when serialized via
+            <c>Uri#toString()</c>.</para>
           <para>
             <format type="text/html">
               <a href="https://developer.android.com/reference/android/telephony/mbms/DownloadRequest#getMaxDestinationUriSize()" title="Reference documentation">Java documentation for <code>android.telephony.mbms.DownloadRequest.getMaxDestinationUriSize()</code>.</a>
@@ -347,8 +347,8 @@
         <ReturnType>Android.Net.Uri</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The source URI to download from.</summary>
-        <value>The source URI to download from</value>
+        <summary>The source <c>Uri</c> to download from.</summary>
+        <value>The source <c>Uri</c> to download from.</value>
         <remarks>
           <para>
             <format type="text/html">