From 54b7d87881db5bd6811e81b834c62322c437b2fe Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 09:59:37 -0500
Subject: [PATCH 1/2] Document StructTimeval conversions

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Android.Systems/StructTimeval.xml | 33 ++++++++++++++++------
 1 file changed, 24 insertions(+), 9 deletions(-)

diff --git a/docs/xml/Android.Systems/StructTimeval.xml b/docs/xml/Android.Systems/StructTimeval.xml
index da243fc0b..5f4f658d4 100644
--- a/docs/xml/Android.Systems/StructTimeval.xml
+++ b/docs/xml/Android.Systems/StructTimeval.xml
@@ -69,10 +69,18 @@
         <Parameter Name="millis" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <param name="millis">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="millis">The value to represent, in milliseconds.</param>
+        <summary>Creates a <c>StructTimeval</c> from a millisecond value.</summary>
+        <returns>A value whose seconds and microseconds components represent <paramref name="millis" />.</returns>
+        <remarks>
+          <para>For negative values, the seconds component is rounded down and the microseconds component remains non-negative.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://android.googlesource.com/platform/libcore/+/de876a01b29230b877c9f408348c38a90ee724a5/luni/src/main/java/android/system/StructTimeval.java#41" title="Source code">AOSP source for <code>StructTimeval.fromMillis(long)</code>.</a>
+            </format>
+          </para>
+          <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://source.android.com/" 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://www.apache.org/licenses/LICENSE-2.0" title="Apache License 2.0">Apache License 2.0.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="JniPeerMembers">
@@ -187,9 +195,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Converts this value to milliseconds.</summary>
+        <returns>The seconds component multiplied by 1,000 plus the microseconds component divided by 1,000.</returns>
+        <remarks>
+          <para>
+            <format type="text/html">
+              <a href="https://android.googlesource.com/platform/libcore/+/de876a01b29230b877c9f408348c38a90ee724a5/luni/src/main/java/android/system/StructTimeval.java#53" title="Source code">AOSP source for <code>StructTimeval.toMillis()</code>.</a>
+            </format>
+          </para>
+          <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://source.android.com/" 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://www.apache.org/licenses/LICENSE-2.0" title="Apache License 2.0">Apache License 2.0.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="TvSec">
@@ -217,7 +232,7 @@
       </ReturnValue>
       <Docs>
         <summary>Seconds.</summary>
-        <value>To be added.</value>
+        <value>The seconds component.</value>
         <remarks>
           <para>Seconds.</para>
           <para>
@@ -258,7 +273,7 @@
       </ReturnValue>
       <Docs>
         <summary>Microseconds.</summary>
-        <value>To be added.</value>
+        <value>The microseconds component.</value>
         <remarks>
           <para>Microseconds.</para>
           <para>

From 77cab11ce34c3360871694dac739b898e8a70431 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 10:10:22 -0500
Subject: [PATCH 2/2] Clarify StructTimeval millisecond conversion

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

diff --git a/docs/xml/Android.Systems/StructTimeval.xml b/docs/xml/Android.Systems/StructTimeval.xml
index 5f4f658d4..e488ac598 100644
--- a/docs/xml/Android.Systems/StructTimeval.xml
+++ b/docs/xml/Android.Systems/StructTimeval.xml
@@ -196,7 +196,7 @@
       <Parameters />
       <Docs>
         <summary>Converts this value to milliseconds.</summary>
-        <returns>The seconds component multiplied by 1,000 plus the microseconds component divided by 1,000.</returns>
+        <returns>The seconds component multiplied by 1,000 plus the microseconds component divided by 1,000 using integer division; sub-millisecond microseconds are truncated.</returns>
         <remarks>
           <para>
             <format type="text/html">