From 2ea1db19968f520e6816f397cc6e190514a779ef Mon Sep 17 00:00:00 2001
From: Robert Simpson <323132+Rob-S@users.noreply.github.com>
Date: Thu, 31 Jul 2025 16:26:53 -0500
Subject: [PATCH] Update DateTimeOffset.xml

"DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)" does not initialize the new instance using "offset of a specified calendar." Per elsewhere on the same page, the calendar is used to interpret the year, month and day, _not_ the offset.
The "calendar" is missing from the similar constructor which includes "microsecond".
---
 xml/System/DateTimeOffset.xml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/xml/System/DateTimeOffset.xml b/xml/System/DateTimeOffset.xml
index 610a554b627..781f620b62d 100644
--- a/xml/System/DateTimeOffset.xml
+++ b/xml/System/DateTimeOffset.xml
@@ -294,7 +294,7 @@
       <Docs>
         <param name="dateTime">A date and time.</param>
         <param name="offset">The time's offset from Coordinated Universal Time (UTC).</param>
-        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified <see cref="T:System.DateTime" /> value and offset.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified <see cref="T:System.DateTime" /> value and <paramref name="offset" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -379,7 +379,7 @@
       <Docs>
         <param name="ticks">A date and time expressed as the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight on January 1, 0001.</param>
         <param name="offset">The time's offset from Coordinated Universal Time (UTC).</param>
-        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified number of ticks and offset.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified number of <paramref name="ticks" /> and <paramref name="offset" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -500,7 +500,7 @@
         <param name="minute">The minutes (0 through 59).</param>
         <param name="second">The seconds (0 through 59).</param>
         <param name="offset">The time's offset from Coordinated Universal Time (UTC).</param>
-        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified year, month, day, hour, minute, second, and offset.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified <paramref name="year" />, <paramref name="month" />, <paramref name="day" />, <paramref name="hour" />, <paramref name="minute" />, <paramref name="second" /> and <paramref name="offset" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -607,7 +607,7 @@
         <param name="second">The seconds (0 through 59).</param>
         <param name="millisecond">The milliseconds (0 through 999).</param>
         <param name="offset">The time's offset from Coordinated Universal Time (UTC).</param>
-        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified year, month, day, hour, minute, second, millisecond, and offset.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified <paramref name="year" />, <paramref name="month" />, <paramref name="day" />, <paramref name="hour" />, <paramref name="minute" />, <paramref name="second" />, <paramref name="millisecond" /> and <paramref name="offset" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -716,7 +716,7 @@
         <param name="millisecond">The milliseconds (0 through 999).</param>
         <param name="calendar">The calendar that is used to interpret <paramref name="year" />, <paramref name="month" />, and <paramref name="day" />.</param>
         <param name="offset">The time's offset from Coordinated Universal Time (UTC).</param>
-        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified <paramref name="year" />, <paramref name="month" />, <paramref name="day" />, <paramref name="hour" />, <paramref name="minute" />, <paramref name="second" />, <paramref name="millisecond" />, <paramref name="calendar" /> and <paramref name="offset" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -911,7 +911,7 @@ This constructor interprets `year`, `month` and `day` as a year, month and day
         <param name="microsecond">The microseconds (0 through 999).</param>
         <param name="calendar">The calendar that is used to interpret <paramref name="year" />, <paramref name="month" />, and <paramref name="day" />.</param>
         <param name="offset">The time's offset from Coordinated Universal Time (UTC).</param>
-        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified <paramref name="year" />, <paramref name="month" />, <paramref name="day" />, <paramref name="hour" />, <paramref name="minute" />, <paramref name="second" />, <paramref name="millisecond" />, <paramref name="microsecond" /> and <paramref name="offset" />.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.DateTimeOffset" /> structure using the specified <paramref name="year" />, <paramref name="month" />, <paramref name="day" />, <paramref name="hour" />, <paramref name="minute" />, <paramref name="second" />, <paramref name="millisecond" />, <paramref name="microsecond" />, <paramref name="calendar" /> and <paramref name="offset" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[