Port documentation for .NET 7.0 Preview6

xml/Microsoft.Extensions.Hosting/HostAbortedException.xml

@@ -20,7 +20,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>The exception that is thrown upon <see cref="T:Microsoft.Extensions.Hosting.IHost" /> abortion.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -37,7 +37,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostAbortedException" /> class with a system-supplied error message.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -57,9 +57,19 @@
         <Parameter Name="message" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="message">The error message that explains the reason for the exception.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostAbortedException" /> class with a specified error message.</summary>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The content of `message` is intended to be understood by humans.
+            The caller of this constructor is required to ensure that this string has been localized for the
+            current system culture.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -79,10 +89,20 @@
         <Parameter Name="innerException" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <param name="innerException">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="message">The error message that explains the reason for the exception.</param>
+        <param name="innerException">The exception that is the cause of the current exception.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostAbortedException" /> class with a specified error message and a reference to the inner exception that is the cause of this exception.</summary>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The content of `message` is intended to be understood by humans.
+            The caller of this constructor is required to ensure that this string has been localized for the
+            current system culture.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>

xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml

@@ -43,7 +43,7 @@
         <summary>Sets the host lifetime to <see cref="T:Microsoft.Extensions.Hosting.Systemd.SystemdLifetime" />,
             provides notification messages for application started and stopping,
             and configures console logging to the systemd format.</summary>
-        <returns />
+        <returns>The <paramref name="hostBuilder" /> instance for chaining.</returns>
         <remarks>
           <para>This is context aware and will only activate if it detects the process is running
                 as a systemd Service.</para>

xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerOptions.xml

@@ -224,7 +224,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the maximum number of enqueued messages. Defaults to 2500.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -245,7 +245,7 @@
         <ReturnType>Microsoft.Extensions.Logging.Console.ConsoleLoggerQueueFullMode</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the desired console logger behavior when the queue becomes full. Defaults to <c>Wait</c>.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerQueueFullMode.xml

@@ -13,7 +13,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Determines the console logger behavior when the queue becomes full.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -34,7 +34,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Drops new log messages when the queue is full.</summary>
       </Docs>
     </Member>
     <Member MemberName="Wait">
@@ -54,7 +54,7 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Blocks the logging threads once the queue limit is reached.</summary>
       </Docs>
     </Member>
   </Members>

xml/System.ComponentModel/DateOnlyConverter.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a type converter to convert <see cref="T:System.DateOnly" /> objects to and from various other representations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.DateOnlyConverter" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -55,10 +55,10 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <param name="context">To be added.</param>
-        <param name="sourceType">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
+        <param name="sourceType">The type to convert from.</param>
+        <summary>Gets a value indicating whether this converter can convert an object in the given source type to a <see cref="T:System.DateOnly" /> object using the specified context.</summary>
+        <returns><see langword="true" /> if this object can perform the conversion; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -89,10 +89,10 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="context">To be added.</param>
-        <param name="destinationType">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
+        <param name="destinationType">The type to convert to.</param>
+        <summary>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</summary>
+        <returns><see langword="true" /> if this converter can perform the conversion; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -117,11 +117,11 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="context">To be added.</param>
-        <param name="culture">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
+        <param name="culture">An optional <see cref="T:System.Globalization.CultureInfo" />. If not supplied, the current culture is assumed.</param>
+        <param name="value">The <see cref="T:System.Object" /> to convert.</param>
+        <summary>Converts the given value object to a <see cref="T:System.DateOnly" /> object.</summary>
+        <returns>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -148,11 +148,11 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <param name="culture">To be added.</param>
-        <param name="value">To be added.</param>
-        <param name="destinationType">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="culture">An optional <see cref="T:System.Globalization.CultureInfo" />. If not supplied, the current culture is assumed.</param>
+        <param name="value">The <see cref="T:System.Object" /> to convert.</param>
+        <param name="destinationType">The <see cref="T:System.Type" /> to convert the value to.</param>
+        <summary>Converts the given value object from a <see cref="T:System.DateOnly" /> object using the arguments.</summary>
+        <returns>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.ComponentModel/HalfConverter.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a type converter to convert half-precision, floating point number objects to and from various other representations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

xml/System.ComponentModel/Int128Converter.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a type converter to convert 128-bit signed integer objects to and from various other representations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

xml/System.ComponentModel/TimeOnlyConverter.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a type converter to convert <see cref="T:System.TimeOnly" /> objects to and from various other representations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.TimeOnlyConverter" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -55,10 +55,10 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <param name="context">To be added.</param>
-        <param name="sourceType">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
+        <param name="sourceType">The type to convert from.</param>
+        <summary>Gets a value indicating whether this converter can convert an object in the given source type to a <see cref="T:System.TimeOnly" /> object using the specified context.</summary>
+        <returns><see langword="true" /> if this object can perform the conversion; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -89,10 +89,10 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="context">To be added.</param>
-        <param name="destinationType">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
+        <param name="destinationType">The type to convert to.</param>
+        <summary>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</summary>
+        <returns><see langword="true" /> if this converter can perform the conversion; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -117,11 +117,11 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="context">To be added.</param>
-        <param name="culture">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
+        <param name="culture">An optional <see cref="T:System.Globalization.CultureInfo" />. If not supplied, the current culture is assumed.</param>
+        <param name="value">The <see cref="T:System.Object" /> to convert.</param>
+        <summary>Converts the given value object to a <see cref="T:System.TimeOnly" /> object.</summary>
+        <returns>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -148,11 +148,11 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <param name="culture">To be added.</param>
-        <param name="value">To be added.</param>
-        <param name="destinationType">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="culture">An optional <see cref="T:System.Globalization.CultureInfo" />. If not supplied, the current culture is assumed.</param>
+        <param name="value">The <see cref="T:System.Object" /> to convert.</param>
+        <param name="destinationType">The <see cref="T:System.Type" /> to convert the value to.</param>
+        <summary>Converts the given value object from a <see cref="T:System.TimeOnly" /> object using the arguments.</summary>
+        <returns>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.ComponentModel/UInt128Converter.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a type converter to convert 128-bit unsigned integer objects to and from various other representations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

xml/System.Data.Common/DbDataSource.xml

@@ -219,7 +219,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -267,8 +267,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.</summary>
+        <returns>A task that represents the asynchronous dispose operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Formats.Tar/GnuTarEntry.xml

@@ -43,7 +43,7 @@ Even though the <xref:System.Formats.Tar.TarEntryFormat.Gnu> format is not POSIX
       </Parameters>
       <Docs>
         <param name="other">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Initializes a new <see cref="T:System.Formats.Tar.GnuTarEntry" /> instance by converting the specified <paramref name="other" /> entry into the GNU format.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Formats.Tar/PaxGlobalExtendedAttributesTarEntry.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a global extended attributes TAR entry from an archive of the PAX format.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -34,9 +34,11 @@
         <Parameter Name="globalExtendedAttributes" Type="System.Collections.Generic.IEnumerable&lt;System.Collections.Generic.KeyValuePair&lt;System.String,System.String&gt;&gt;" />
       </Parameters>
       <Docs>
-        <param name="globalExtendedAttributes">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="globalExtendedAttributes">An enumeration of string key-value pairs that represents the metadata to include as global extended attributes.</param>
+        <summary>Initializes a new <see cref="T:System.Formats.Tar.PaxGlobalExtendedAttributesTarEntry" /> instance with the specified global extended attributes enumeration.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="globalExtendedAttributes" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="GlobalExtendedAttributes">
@@ -55,7 +57,7 @@
         <ReturnType>System.Collections.Generic.IReadOnlyDictionary&lt;System.String,System.String&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Returns the global extended attributes stored in this entry.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Formats.Tar/PaxTarEntry.xml

@@ -35,7 +35,7 @@
       </Parameters>
       <Docs>
         <param name="other">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Initializes a new <see cref="T:System.Formats.Tar.PaxTarEntry" /> instance by converting the specified <paramref name="other" /> entry into the PAX format.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Formats.Tar/TarEntry.xml

@@ -182,7 +182,7 @@ An I/O problem occurred.</exception>
         <ReturnType>System.Formats.Tar.TarEntryFormat</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The format of the entry.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>