diff --git a/xml/Microsoft.Extensions.Hosting/HostAbortedException.xml b/xml/Microsoft.Extensions.Hosting/HostAbortedException.xml
index 06fc732f6ff..f7a4d61625b 100644
--- a/xml/Microsoft.Extensions.Hosting/HostAbortedException.xml
+++ b/xml/Microsoft.Extensions.Hosting/HostAbortedException.xml
@@ -20,7 +20,7 @@
- To be added.
+ The exception that is thrown upon abortion.
To be added.
@@ -37,7 +37,7 @@
- To be added.
+ Initializes a new instance of the class with a system-supplied error message.
To be added.
@@ -57,9 +57,19 @@
- To be added.
- To be added.
- To be added.
+ The error message that explains the reason for the exception.
+ Initializes a new instance of the class with a specified error message.
+
+
+
@@ -79,10 +89,20 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The error message that explains the reason for the exception.
+ The exception that is the cause of the current exception.
+ Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception.
+
+
+
diff --git a/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml b/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml
index b6d366b47a0..1ce80d95518 100644
--- a/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml
+++ b/xml/Microsoft.Extensions.Hosting/SystemdHostBuilderExtensions.xml
@@ -43,7 +43,7 @@
Sets the host lifetime to ,
provides notification messages for application started and stopping,
and configures console logging to the systemd format.
-
+ The instance for chaining.
This is context aware and will only activate if it detects the process is running
as a systemd Service.
diff --git a/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerOptions.xml b/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerOptions.xml
index add636f6409..f8f48f1e35e 100644
--- a/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerOptions.xml
+++ b/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerOptions.xml
@@ -224,7 +224,7 @@
System.Int32
- To be added.
+ Gets or sets the maximum number of enqueued messages. Defaults to 2500.
To be added.
To be added.
@@ -245,7 +245,7 @@
Microsoft.Extensions.Logging.Console.ConsoleLoggerQueueFullMode
- To be added.
+ Gets or sets the desired console logger behavior when the queue becomes full. Defaults to Wait.
To be added.
To be added.
diff --git a/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerQueueFullMode.xml b/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerQueueFullMode.xml
index 9ffcbaeedec..99c66596d99 100644
--- a/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerQueueFullMode.xml
+++ b/xml/Microsoft.Extensions.Logging.Console/ConsoleLoggerQueueFullMode.xml
@@ -13,7 +13,7 @@
System.Enum
- To be added.
+ Determines the console logger behavior when the queue becomes full.
To be added.
@@ -34,7 +34,7 @@
1
- To be added.
+ Drops new log messages when the queue is full.
@@ -54,7 +54,7 @@
0
- To be added.
+ Blocks the logging threads once the queue limit is reached.
diff --git a/xml/System.ComponentModel/DateOnlyConverter.xml b/xml/System.ComponentModel/DateOnlyConverter.xml
index 1a9b4b00996..0acb07dcac6 100644
--- a/xml/System.ComponentModel/DateOnlyConverter.xml
+++ b/xml/System.ComponentModel/DateOnlyConverter.xml
@@ -14,7 +14,7 @@
- To be added.
+ Provides a type converter to convert objects to and from various other representations.
To be added.
@@ -31,7 +31,7 @@
- To be added.
+ Initializes a new instance of the class.
To be added.
@@ -55,10 +55,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ An that provides a format context.
+ The type to convert from.
+ Gets a value indicating whether this converter can convert an object in the given source type to a object using the specified context.
+ if this object can perform the conversion; otherwise, .
To be added.
@@ -89,10 +89,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ An that provides a format context.
+ The type to convert to.
+ Gets a value indicating whether this converter can convert an object to the given destination type using the context.
+ if this converter can perform the conversion; otherwise, .
To be added.
@@ -117,11 +117,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ An that provides a format context.
+ An optional . If not supplied, the current culture is assumed.
+ The to convert.
+ Converts the given value object to a object.
+ An that represents the converted .
To be added.
@@ -148,11 +148,11 @@
To be added.
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ An optional . If not supplied, the current culture is assumed.
+ The to convert.
+ The to convert the value to.
+ Converts the given value object from a object using the arguments.
+ An that represents the converted .
To be added.
diff --git a/xml/System.ComponentModel/HalfConverter.xml b/xml/System.ComponentModel/HalfConverter.xml
index 40d07276bac..c7496b906b5 100644
--- a/xml/System.ComponentModel/HalfConverter.xml
+++ b/xml/System.ComponentModel/HalfConverter.xml
@@ -14,7 +14,7 @@
- To be added.
+ Provides a type converter to convert half-precision, floating point number objects to and from various other representations.
To be added.
diff --git a/xml/System.ComponentModel/Int128Converter.xml b/xml/System.ComponentModel/Int128Converter.xml
index 314207046f9..6cae38c9bf7 100644
--- a/xml/System.ComponentModel/Int128Converter.xml
+++ b/xml/System.ComponentModel/Int128Converter.xml
@@ -14,7 +14,7 @@
- To be added.
+ Provides a type converter to convert 128-bit signed integer objects to and from various other representations.
To be added.
diff --git a/xml/System.ComponentModel/TimeOnlyConverter.xml b/xml/System.ComponentModel/TimeOnlyConverter.xml
index 3891c061f6f..4b3081499c8 100644
--- a/xml/System.ComponentModel/TimeOnlyConverter.xml
+++ b/xml/System.ComponentModel/TimeOnlyConverter.xml
@@ -14,7 +14,7 @@
- To be added.
+ Provides a type converter to convert objects to and from various other representations.
To be added.
@@ -31,7 +31,7 @@
- To be added.
+ Initializes a new instance of the class.
To be added.
@@ -55,10 +55,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ An that provides a format context.
+ The type to convert from.
+ Gets a value indicating whether this converter can convert an object in the given source type to a object using the specified context.
+ if this object can perform the conversion; otherwise, .
To be added.
@@ -89,10 +89,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ An that provides a format context.
+ The type to convert to.
+ Gets a value indicating whether this converter can convert an object to the given destination type using the context.
+ if this converter can perform the conversion; otherwise, .
To be added.
@@ -117,11 +117,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ An that provides a format context.
+ An optional . If not supplied, the current culture is assumed.
+ The to convert.
+ Converts the given value object to a object.
+ An that represents the converted .
To be added.
@@ -148,11 +148,11 @@
To be added.
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ An optional . If not supplied, the current culture is assumed.
+ The to convert.
+ The to convert the value to.
+ Converts the given value object from a object using the arguments.
+ An that represents the converted .
To be added.
diff --git a/xml/System.ComponentModel/UInt128Converter.xml b/xml/System.ComponentModel/UInt128Converter.xml
index 16ea0169a0c..94f8b70fa76 100644
--- a/xml/System.ComponentModel/UInt128Converter.xml
+++ b/xml/System.ComponentModel/UInt128Converter.xml
@@ -14,7 +14,7 @@
- To be added.
+ Provides a type converter to convert 128-bit unsigned integer objects to and from various other representations.
To be added.
diff --git a/xml/System.Data.Common/DbDataSource.xml b/xml/System.Data.Common/DbDataSource.xml
index 614123ec360..1d13bb54904 100644
--- a/xml/System.Data.Common/DbDataSource.xml
+++ b/xml/System.Data.Common/DbDataSource.xml
@@ -219,7 +219,7 @@
- To be added.
+ Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
To be added.
@@ -267,8 +267,8 @@
- To be added.
- To be added.
+ Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.
+ A task that represents the asynchronous dispose operation.
To be added.
diff --git a/xml/System.Formats.Tar/GnuTarEntry.xml b/xml/System.Formats.Tar/GnuTarEntry.xml
index a5ab6196d61..1f50ace838c 100644
--- a/xml/System.Formats.Tar/GnuTarEntry.xml
+++ b/xml/System.Formats.Tar/GnuTarEntry.xml
@@ -43,7 +43,7 @@ Even though the format is not POSIX
To be added.
- To be added.
+ Initializes a new instance by converting the specified entry into the GNU format.
To be added.
diff --git a/xml/System.Formats.Tar/PaxGlobalExtendedAttributesTarEntry.xml b/xml/System.Formats.Tar/PaxGlobalExtendedAttributesTarEntry.xml
index b3c6e1dbd42..23b58c64c70 100644
--- a/xml/System.Formats.Tar/PaxGlobalExtendedAttributesTarEntry.xml
+++ b/xml/System.Formats.Tar/PaxGlobalExtendedAttributesTarEntry.xml
@@ -14,7 +14,7 @@
- To be added.
+ Represents a global extended attributes TAR entry from an archive of the PAX format.
To be added.
@@ -34,9 +34,11 @@
- To be added.
- To be added.
+ An enumeration of string key-value pairs that represents the metadata to include as global extended attributes.
+ Initializes a new instance with the specified global extended attributes enumeration.
To be added.
+
+ is .
@@ -55,7 +57,7 @@
System.Collections.Generic.IReadOnlyDictionary<System.String,System.String>
- To be added.
+ Returns the global extended attributes stored in this entry.
To be added.
To be added.
diff --git a/xml/System.Formats.Tar/PaxTarEntry.xml b/xml/System.Formats.Tar/PaxTarEntry.xml
index 338c4587c85..c2c40297dc8 100644
--- a/xml/System.Formats.Tar/PaxTarEntry.xml
+++ b/xml/System.Formats.Tar/PaxTarEntry.xml
@@ -35,7 +35,7 @@
To be added.
- To be added.
+ Initializes a new instance by converting the specified entry into the PAX format.
To be added.
diff --git a/xml/System.Formats.Tar/TarEntry.xml b/xml/System.Formats.Tar/TarEntry.xml
index 0a2cc1f0aba..00efc87328c 100644
--- a/xml/System.Formats.Tar/TarEntry.xml
+++ b/xml/System.Formats.Tar/TarEntry.xml
@@ -182,7 +182,7 @@ An I/O problem occurred.
System.Formats.Tar.TarEntryFormat
- To be added.
+ The format of the entry.
To be added.
To be added.
diff --git a/xml/System.Formats.Tar/TarEntryFormat.xml b/xml/System.Formats.Tar/TarEntryFormat.xml
index 8eb086f7dd0..4bdf927fe8b 100644
--- a/xml/System.Formats.Tar/TarEntryFormat.xml
+++ b/xml/System.Formats.Tar/TarEntryFormat.xml
@@ -13,7 +13,7 @@
System.Enum
- To be added.
+ Specifies the supported formats that tar entries can use.
To be added.
@@ -34,7 +34,7 @@
4
- To be added.
+ GNU tar entry format (gnu).
@@ -54,7 +54,7 @@
3
- To be added.
+ POSIX IEEE 1003.1-2001 ("POSIX.1") Pax Interchange tar entry format.
@@ -74,7 +74,7 @@
0
- To be added.
+ Tar entry format undetermined.
@@ -94,7 +94,7 @@
2
- To be added.
+ POSIX IEEE 1003.1-1988 Unix Standard tar entry format.
@@ -114,7 +114,7 @@
1
- To be added.
+ 1979 Version 7 AT&T Unix tar entry format.
diff --git a/xml/System.Formats.Tar/TarWriter.xml b/xml/System.Formats.Tar/TarWriter.xml
index c453f4a5847..5b8debb1913 100644
--- a/xml/System.Formats.Tar/TarWriter.xml
+++ b/xml/System.Formats.Tar/TarWriter.xml
@@ -38,9 +38,17 @@
- To be added.
- To be added.
- To be added.
+ The stream to write to.
+ Initializes a instance that can write tar entries to the specified stream and closes the upon disposal of this instance.
+
+ is used as the default format of the entries written to the archive using the method.
+
+ ]]>
+
@@ -59,9 +67,10 @@
- To be added.
- To be added.
- To be added.
+ The stream to write to.
+
+ to dispose the when this instance is disposed; to leave the stream open.
+ Initializes a instance that can write tar entries to the specified stream and optionally leaves the stream open upon disposal of this instance. When using this constructor, the format of the resulting archive is .
To be added.
diff --git a/xml/System.Formats.Tar/UstarTarEntry.xml b/xml/System.Formats.Tar/UstarTarEntry.xml
index b528705b83a..430e339c832 100644
--- a/xml/System.Formats.Tar/UstarTarEntry.xml
+++ b/xml/System.Formats.Tar/UstarTarEntry.xml
@@ -35,7 +35,7 @@
To be added.
- To be added.
+ Initializes a new instance by converting the specified entry into the Ustar format.
To be added.
diff --git a/xml/System.Formats.Tar/V7TarEntry.xml b/xml/System.Formats.Tar/V7TarEntry.xml
index eb68cb653ea..006d388099b 100644
--- a/xml/System.Formats.Tar/V7TarEntry.xml
+++ b/xml/System.Formats.Tar/V7TarEntry.xml
@@ -35,7 +35,7 @@
To be added.
- To be added.
+ Initializes a new instance by converting the specified entry into the V7 format.
To be added.
diff --git a/xml/System.IO.Compression/ZipArchiveEntry.xml b/xml/System.IO.Compression/ZipArchiveEntry.xml
index be28e5d1739..5d75a483098 100644
--- a/xml/System.IO.Compression/ZipArchiveEntry.xml
+++ b/xml/System.IO.Compression/ZipArchiveEntry.xml
@@ -326,7 +326,7 @@ If the comment byte length is larger than , it will
System.Boolean
- To be added.
+ Gets a value that indicates whether the entry is encrypted.
To be added.
To be added.
diff --git a/xml/System.IO/Directory.xml b/xml/System.IO/Directory.xml
index cecefe89663..5034aefc993 100644
--- a/xml/System.IO/Directory.xml
+++ b/xml/System.IO/Directory.xml
@@ -291,11 +291,21 @@ Directory::CreateDirectory("c:\\Users\\User1\\Public\\Html");
- To be added.
- To be added.
- To be added.
- To be added.
+ The directory to create.
+ A bitwise combination of the enumeration values that specifies the Unix file mode used to create directories.
+ Creates all directories and subdirectories in the specified path with the specified permissions unless they already exist.
+ An object that represents the directory at the specified path. This object is returned regardless of whether a directory at the specified path already exists.
To be added.
+
+ is a zero-length string, or contains one or more invalid characters. You can query for invalid characters by using the method.
+
+ is .
+ The file mode is invalid.
+ The caller does not have the required permission.
+ The specified path exceeds the system-defined maximum length.
+
+ is a file.
+ A component of the is not a directory.
diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml
index 8131621f037..84a295c09da 100644
--- a/xml/System.IO/File.xml
+++ b/xml/System.IO/File.xml
@@ -2703,10 +2703,11 @@ An I/O error occurred.
- To be added.
- To be added.
- To be added.
+ The file handle.
+ Gets the of the specified file handle.
+ The of the file handle.
To be added.
+ The file is closed.
@@ -2740,10 +2741,18 @@ An I/O error occurred.
- To be added.
- To be added.
- To be added.
+ The path to the file.
+ Gets the of the file on the path.
+ The of the file on the path.
To be added.
+
+ is a zero-length string, or contains one or more invalid characters. You can query for invalid characters by using the method.
+
+ is .
+ The caller does not have the required permission.
+ The specified path exceeds the system-defined maximum length.
+ A component of the is not a directory.
+ The file cannot be found.
@@ -5653,10 +5662,13 @@ There are too many levels of symbolic links.
- To be added.
- To be added.
- To be added.
+ The file handle.
+ The Unix file mode.
+ Sets the specified of the specified file handle.
To be added.
+ The file mode is invalid.
+ The caller does not have the required permission.
+ The file is closed.
@@ -5691,10 +5703,19 @@ There are too many levels of symbolic links.
- To be added.
- To be added.
- To be added.
+ The path to the file.
+ The Unix file mode.
+ Sets the specified of the file on the specified path.
To be added.
+
+ is a zero-length string, or contains one or more invalid characters. You can query for invalid characters by using the method.
+
+ is .
+ The file mode is invalid.
+ The caller does not have the required permission.
+ The specified path exceeds the system-defined maximum length.
+ A component of the is not a directory.
+ The file cannot be found.
diff --git a/xml/System.IO/FileStreamOptions.xml b/xml/System.IO/FileStreamOptions.xml
index 33f3bcc5d98..35fdcbc2ca0 100644
--- a/xml/System.IO/FileStreamOptions.xml
+++ b/xml/System.IO/FileStreamOptions.xml
@@ -225,9 +225,11 @@ It's permissible to write more than what was initially preallocated. As long as
System.Nullable<System.IO.UnixFileMode>
- To be added.
+ Gets or sets the Unix file mode used when a new file is created.
To be added.
To be added.
+
+ is an invalid file mode.
diff --git a/xml/System.IO/FileSystemInfo.xml b/xml/System.IO/FileSystemInfo.xml
index c4362344b0b..5a60f3f2c0b 100644
--- a/xml/System.IO/FileSystemInfo.xml
+++ b/xml/System.IO/FileSystemInfo.xml
@@ -1650,9 +1650,27 @@ There are too many levels of symbolic links.
System.IO.UnixFileMode
- To be added.
- To be added.
- To be added.
+ Gets or sets the Unix file mode for the current file or directory.
+
+ of the current .
+
+ properties are accessed. To get the latest value, call the method.
+
+If the path doesn't exist as of the last cached state, the return value is `(UnixFileMode)(-1)`. or can only be thrown when setting the value.
+
+ ]]>
+
+ The file mode is invalid.
+ The caller does not have the required permission.
+ The specified path exceeds the system-defined maximum length.
+ The specified path is invalid. Only thrown when setting the property value.
+ The specified file doesn't exist. Only thrown when setting the property value.
+
+ cannot initialize the data.
diff --git a/xml/System.IO/UnixFileMode.xml b/xml/System.IO/UnixFileMode.xml
index f362c7c1207..f9bd0c6b90c 100644
--- a/xml/System.IO/UnixFileMode.xml
+++ b/xml/System.IO/UnixFileMode.xml
@@ -19,7 +19,10 @@
- To be added.
+
+ Represents the Unix filesystem permissions.
+ This enumeration supports a bitwise combination of its member values.
+
To be added.
@@ -40,7 +43,7 @@
8
- To be added.
+ Execute permission for group.
@@ -60,7 +63,7 @@
32
- To be added.
+ Read permission for group.
@@ -80,7 +83,7 @@
16
- To be added.
+ Write permission for group.
@@ -100,7 +103,7 @@
0
- To be added.
+ No permissions.
@@ -120,7 +123,7 @@
1
- To be added.
+ Execute permission for others.
@@ -140,7 +143,7 @@
4
- To be added.
+ Read permission for others.
@@ -160,7 +163,7 @@
2
- To be added.
+ Write permission for others.
@@ -180,7 +183,7 @@
1024
- To be added.
+ Set group permission.
@@ -200,7 +203,7 @@
2048
- To be added.
+ Set user permission.
@@ -220,7 +223,7 @@
512
- To be added.
+ Sticky bit permission.
@@ -240,7 +243,7 @@
64
- To be added.
+ Execute permission for owner.
@@ -260,7 +263,7 @@
256
- To be added.
+ Read permission for owner.
@@ -280,7 +283,7 @@
128
- To be added.
+ Write permission for owner.
diff --git a/xml/System.Net.Security/NegotiateAuthentication.xml b/xml/System.Net.Security/NegotiateAuthentication.xml
index b69338b8d0d..9b53d66e553 100644
--- a/xml/System.Net.Security/NegotiateAuthentication.xml
+++ b/xml/System.Net.Security/NegotiateAuthentication.xml
@@ -18,7 +18,7 @@
- To be added.
+ Represents a stateful authentication exchange that uses the Negotiate, NTLM, or Kerberos security protocols to authenticate the client or server, in client-server communication.
To be added.
@@ -38,8 +38,8 @@
- To be added.
- To be added.
+ The property bag for the authentication options.
+ Initializes a new instance of the for client-side authentication session.
To be added.
@@ -59,8 +59,8 @@
- To be added.
- To be added.
+ The property bag for the authentication options.
+ Initializes a new instance of the for server-side authentication session.
To be added.
@@ -84,7 +84,7 @@
- To be added.
+ Releases the unmanaged resources used by the and optionally releases the managed resources.
To be added.
@@ -108,11 +108,26 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ Incoming authentication token, or empty value when initiating the authentication exchange.
+ Status code returned by the authentication provider.
+ Evaluates an authentication token sent by the other party and returns a token in response.
+ An outgoing authentication token to be sent to the other party.
+
+
+ or status code.
+ Any other status code indicates an unrecoverable error.
+
+When is returned, the
+ return value is an authentication token to be transported to the other party.
+
+ ]]>
+
@@ -135,11 +150,27 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ Incoming authentication token, or empty value when initiating the authentication exchange. Encoded as base64.
+ Status code returned by the authentication provider.
+ Evaluates an authentication token sent by the other party and returns a token in response.
+ An outgoing authentication token to be sent to the other party, encoded as base64.
+
+
+ or status code.
+ Any other status code indicates an unrecoverable error.
+
+When is returned, the
+ return value is an authentication token to be transported to the other party.
+
+ ]]>
+
@@ -158,7 +189,7 @@
System.Boolean
- To be added.
+ Gets a value that indicates whether authentication was successfully completed and the session was established.
To be added.
To be added.
@@ -179,7 +210,7 @@
System.Boolean
- To be added.
+ Gets a value that indicates whether data encryption was negotiated.
To be added.
To be added.
@@ -200,7 +231,7 @@
System.Boolean
- To be added.
+ Gets a value that indicates whether both server and client have been authenticated.
To be added.
To be added.
@@ -221,7 +252,7 @@
System.Boolean
- To be added.
+ Gets a value that indicates whether the local side of the authentication is representing the server.
To be added.
To be added.
@@ -242,7 +273,7 @@
System.Boolean
- To be added.
+ Gets a value that indicates whether data signing was negotiated.
To be added.
To be added.
@@ -263,9 +294,26 @@
System.String
- To be added.
+ Gets the name of the negotiated authentication package.
To be added.
- To be added.
+
+ ). For
+ unfinished authentication sessions, the value is undefined and usually
+ returns the initial authentication package name specified in
+ or
+ .
+
+If the Negotiate package was used for authentication, the value of this
+ property will be Kerberos, NTLM, or any other specific protocol that was
+ negotiated between both sides of the authentication.
+
+ ]]>
+
@@ -284,9 +332,21 @@
System.Net.Security.ProtectionLevel
- To be added.
+ Indicates the negotiated level of protection.
To be added.
- To be added.
+
+ ). The
+ protection level can be higher than the initially requested protection
+ level specified by or
+ .
+
+ ]]>
+
@@ -305,9 +365,11 @@
System.Security.Principal.IIdentity
- To be added.
- To be added.
+ Gets information about the identity of the remote party.
+ An object that describes the identity of the remote endpoint.
To be added.
+ Authentication failed or has not occurred.
+ System error occurred when trying to retrieve the identity.
@@ -326,9 +388,21 @@
System.String
- To be added.
+ Gets the target name (service principal name) of the server.
To be added.
- To be added.
+
+ ).
+
+For the client side of the authentication, the property returns the target name
+ specified in .
+
+ ]]>
+
diff --git a/xml/System.Net.Security/NegotiateAuthenticationClientOptions.xml b/xml/System.Net.Security/NegotiateAuthenticationClientOptions.xml
index 9c15b5ec2d2..3362c76b663 100644
--- a/xml/System.Net.Security/NegotiateAuthenticationClientOptions.xml
+++ b/xml/System.Net.Security/NegotiateAuthenticationClientOptions.xml
@@ -14,7 +14,7 @@
- To be added.
+ Represents a property bag for the client side of an authentication exchange.
To be added.
@@ -51,7 +51,7 @@
System.Security.Authentication.ExtendedProtection.ChannelBinding
- To be added.
+ Gets or sets the channel binding that's used for extended protection.
To be added.
To be added.
@@ -72,7 +72,8 @@
System.Net.NetworkCredential
- To be added.
+ Gets or sets the network credential that's used to establish the identity of the client.
+ The default value is .
To be added.
To be added.
@@ -93,7 +94,8 @@
System.String
- To be added.
+ Gets or sets the GSSAPI authentication package used for the authentication.
+ Common values are Negotiate, NTLM, or Kerberos. The default value is Negotiate.
To be added.
To be added.
@@ -114,7 +116,7 @@
System.Net.Security.ProtectionLevel
- To be added.
+ Gets or sets the required level of protection of the authentication exchange and any further data exchange. The default value is .
To be added.
To be added.
@@ -135,7 +137,7 @@
System.String
- To be added.
+ Gets or sets the service principal name (SPN) that uniquely identifies the server for authentication.
To be added.
To be added.
diff --git a/xml/System.Net.Security/NegotiateAuthenticationServerOptions.xml b/xml/System.Net.Security/NegotiateAuthenticationServerOptions.xml
index f010e0f1838..de2fb3a6c31 100644
--- a/xml/System.Net.Security/NegotiateAuthenticationServerOptions.xml
+++ b/xml/System.Net.Security/NegotiateAuthenticationServerOptions.xml
@@ -14,7 +14,7 @@
- To be added.
+ Represents a property bag for the server side of an authentication exchange.
To be added.
@@ -51,7 +51,7 @@
System.Security.Authentication.ExtendedProtection.ChannelBinding
- To be added.
+ Gets or sets the channel binding that's used for extended protection.
To be added.
To be added.
@@ -72,7 +72,8 @@
System.Net.NetworkCredential
- To be added.
+ Gets or sets the network credential that's used to establish the identity of the client.
+ The default value is .
To be added.
To be added.
@@ -93,7 +94,8 @@
System.String
- To be added.
+ Gets or sets the GSSAPI authentication package used for the authentication.
+ Common values are Negotiate, NTLM, or Kerberos. The default value is Negotiate.
To be added.
To be added.
@@ -114,7 +116,7 @@
System.Net.Security.ProtectionLevel
- To be added.
+ Gets or sets the required level of protection of the authentication exchange and any further data exchange. The default value is .
To be added.
To be added.
diff --git a/xml/System.Net.Security/NegotiateAuthenticationStatusCode.xml b/xml/System.Net.Security/NegotiateAuthenticationStatusCode.xml
index 8389b6194b0..dc800725ee1 100644
--- a/xml/System.Net.Security/NegotiateAuthenticationStatusCode.xml
+++ b/xml/System.Net.Security/NegotiateAuthenticationStatusCode.xml
@@ -13,7 +13,7 @@
System.Enum
- To be added.
+ Specifies the statuses for a single step of an authentication exchange.
To be added.
@@ -34,7 +34,7 @@
3
- To be added.
+ Channel binding mismatch between client and server.
@@ -54,7 +54,7 @@
0
- To be added.
+ Operation completed successfully.
@@ -74,7 +74,7 @@
6
- To be added.
+ Referenced authentication context has expired.
@@ -94,7 +94,7 @@
1
- To be added.
+ Operation completed successfully but more tokens are to be exchanged with the other party.
@@ -114,7 +114,7 @@
7
- To be added.
+ Authentication credentials have expired.
@@ -134,7 +134,7 @@
2
- To be added.
+ Operation resulted in failure but no specific error code was given.
@@ -154,7 +154,7 @@
8
- To be added.
+ Consistency checks performed on the credential failed.
@@ -174,7 +174,7 @@
9
- To be added.
+ Checks performed on the authentication token failed.
@@ -194,7 +194,7 @@
5
- To be added.
+ Message was altered and failed an integrity check validation.
@@ -214,7 +214,7 @@
12
- To be added.
+ Authentication token was identfied as duplicate, old, or out of expected sequence.
@@ -234,7 +234,7 @@
11
- To be added.
+ Requested protection level is not supported.
@@ -254,7 +254,7 @@
10
- To be added.
+ The supplied credentials were not valid for context acceptance, or the credential handle did not reference any credentials.
@@ -274,7 +274,7 @@
4
- To be added.
+ Unsupported authentication package was requested.
diff --git a/xml/System.Numerics/IRootFunctions`1.xml b/xml/System.Numerics/IRootFunctions`1.xml
index 59b2891b68a..72aeb707b02 100644
--- a/xml/System.Numerics/IRootFunctions`1.xml
+++ b/xml/System.Numerics/IRootFunctions`1.xml
@@ -68,10 +68,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The value to square and add to .
+ The value to square and add to .
+ Computes the hypotenuse given two values representing the lengths of the shorter sides in a right-angled triangle.
+ The square root of -squared plus -squared.
To be added.
diff --git a/xml/System.Numerics/ITrigonometricFunctions`1.xml b/xml/System.Numerics/ITrigonometricFunctions`1.xml
index d87643cc7f7..3b8bb4f9c15 100644
--- a/xml/System.Numerics/ITrigonometricFunctions`1.xml
+++ b/xml/System.Numerics/ITrigonometricFunctions`1.xml
@@ -45,7 +45,15 @@
The value, in radians, whose arc-cosine is to be computed.
Computes the arc-cosine of a value.
The arc-cosine of .
- To be added.
+
+
+
@@ -67,10 +75,18 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The value whose arc-cosine is to be computed.
+ Computes the arc-cosine of a value and divides the result by pi.
+ The arc-cosine of , divided by pi.
+
+
+
@@ -95,7 +111,15 @@
The value, in radians, whose arc-sine is to be computed.
Computes the arc-sine of a value.
The arc-sine of .
- To be added.
+
+
+
@@ -117,10 +141,18 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The value whose arc-sine is to be computed.
+ Computes the arc-sine of a value and divides the result by pi.
+ The arc-sine of , divided by pi.
+
+
+
@@ -145,7 +177,15 @@
The value, in radians, whose arc-tangent is to be computed.
Computes the arc-tangent of a value.
The arc-tangent of .
- To be added.
+
+
+
@@ -221,10 +261,18 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The value whose arc-tangent is to be computed.
+ Computes the arc-tangent of a value and divides the result by pi.
+ The arc-tangent of , divided by pi.
+
+
+
@@ -249,7 +297,15 @@
The value, in radians, whose cosine is to be computed.
Computes the cosine of a value.
The cosine of .
- To be added.
+
+
+
@@ -271,10 +327,18 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The value, in half-revolutions, whose cosine is to be computed.
+ Computes the cosine of a value that has been multipled by pi.
+ The cosine of multiplied-by pi.
+
+
+
@@ -299,7 +363,15 @@
The value, in radians, whose sine is to be computed.
Computes the sine of a value.
The sine of .
- To be added.
+
+
+
@@ -330,7 +402,15 @@
The value, in radians, whose sine and cosine are to be computed.
Computes the sine and cosine of a value.
The sine and cosine of .
- To be added.
+
+
+
@@ -352,10 +432,18 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The value, in half-revolutions, that is multipled by pi before computing its sine.
+ Computes the sine of a value that has been multiplied by pi.
+ The sine of multiplied-by pi.
+
+
+
@@ -380,7 +468,15 @@
The value, in radians, whose tangent is to be computed.
Computes the tangent of a value.
The tangent of .
- To be added.
+
+
+
@@ -402,10 +498,18 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The value, in half-revolutions, that is multipled by pi before computing its tangent.
+ Computes the tangent of a value that has been multipled by pi.
+ The tangent of multiplied-by pi.
+
+
+
diff --git a/xml/System.Runtime.CompilerServices/MetadataUpdateOriginalTypeAttribute.xml b/xml/System.Runtime.CompilerServices/MetadataUpdateOriginalTypeAttribute.xml
index 560d2a407a6..4ef5e8d9dcf 100644
--- a/xml/System.Runtime.CompilerServices/MetadataUpdateOriginalTypeAttribute.xml
+++ b/xml/System.Runtime.CompilerServices/MetadataUpdateOriginalTypeAttribute.xml
@@ -20,8 +20,8 @@
- To be added.
- To be added.
+ Emitted by the compiler when a type that's marked with is updated during a hot reload session.
+ This attribute is emitted by Roslyn when a type that's marked with (or derives from a type that's marked with) is updated during a hot reload session. points to the original version of the updated type. The next update of the type will have the same . Frameworks that provide support for hot reload by implementing a can use this attribute to relate an updated type to its original version.
@@ -40,8 +40,8 @@
- To be added.
- To be added.
+ The original type that was updated.
+ Initializes a new instance of the class.
To be added.
diff --git a/xml/System.Runtime.InteropServices/NFloat.xml b/xml/System.Runtime.InteropServices/NFloat.xml
index f5ae258b06e..d375640fe77 100644
--- a/xml/System.Runtime.InteropServices/NFloat.xml
+++ b/xml/System.Runtime.InteropServices/NFloat.xml
@@ -342,7 +342,15 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
Computes the arc-cosine of a value.
The arc-cosine of .
- To be added.
+
+
+
@@ -396,9 +404,17 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-cosine of a value and divides the result by pi.
+ The arc-cosine of , divided by pi.
+
+
+
@@ -426,7 +442,15 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
Computes the arc-sine of a value.
The arc-sine of .
- To be added.
+
+
+
@@ -480,9 +504,17 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-sine of a value and divides the result by pi.
+ The arc-sine of , divided by pi.
+
+
+
@@ -510,7 +542,15 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
Computes the arc-tangent of a value.
The arc-tangent of .
- To be added.
+
+
+
@@ -540,7 +580,15 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
Computes the arc-tangent of the quotient of two values.
The arc-tangent of divided-by .
- To be added.
+
+
+
@@ -568,9 +616,17 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent for the quotient of two values and divides the result by pi.
+ The arc-tangent of divided-by , divided by pi.
+
+
+
@@ -624,9 +680,17 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent of a value and divides the result by pi.
+ The arc-tangent of , divided by pi.
+
+
+
@@ -926,7 +990,15 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
Computes the cosine of a value.
The cosine of .
- To be added.
+
+
+
@@ -980,9 +1052,17 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the cosine of a value that has been multipled by pi.
+ The cosine of multiplied-by pi.
+
+
+
@@ -1398,8 +1478,8 @@ It is meant to be used as an exchange type at the managed/unmanaged boundary to
To be added.
To be added.
- To be added.
- To be added.
+ Computes the hypotenuse given two values representing the lengths of the shorter sides in a right-angled triangle.
+ The square root of -squared plus -squared.
To be added.
@@ -4563,7 +4643,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine of a value.
The sine of .
- To be added.
+
+
+
@@ -4597,7 +4685,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine and cosine of a value.
The sine and cosine of .
- To be added.
+
+
+
@@ -4651,9 +4747,17 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the sine of a value that has been multiplied by pi.
+ The sine of multiplied-by pi.
+
+
+
@@ -4954,7 +5058,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the tangent of a value.
The tangent of .
- To be added.
+
+
+
@@ -5008,9 +5120,17 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the tangent of a value that has been multipled by pi.
+ The tangent of multiplied-by pi.
+
+
+
diff --git a/xml/System.Runtime.InteropServices/NativeMemory.xml b/xml/System.Runtime.InteropServices/NativeMemory.xml
index fd0a1254372..478bb07c259 100644
--- a/xml/System.Runtime.InteropServices/NativeMemory.xml
+++ b/xml/System.Runtime.InteropServices/NativeMemory.xml
@@ -446,10 +446,20 @@ This method is a thin wrapper over the C `calloc` API.
- To be added.
- To be added.
- To be added.
- To be added.
+ A pointer to the block of memory that should be cleared.
+ The size, in bytes, of the block to clear.
+ Clears a block of memory.
+
+
+
diff --git a/xml/System.Security.Cryptography/PemEncoding.xml b/xml/System.Security.Cryptography/PemEncoding.xml
index fc335e5cbf3..bd6ae009d91 100644
--- a/xml/System.Security.Cryptography/PemEncoding.xml
+++ b/xml/System.Security.Cryptography/PemEncoding.xml
@@ -287,11 +287,31 @@ This method always wraps the base-64 encoded text to 64 characters, per the reco
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The label to encode.
+ The data to encode.
+ Creates an encoded PEM with the given label and data.
+ A string of the encoded PEM.
+
+
+
+
+ exceeds the maximum possible label length.
+
+-or-
+
+ exceeds the maximum possible encoded data length.
+ The resulting PEM-encoded text is larger than .
+
+-or-
+
+ contains invalid characters.
diff --git a/xml/System.Text.Json.Serialization.Metadata/DefaultJsonTypeInfoResolver.xml b/xml/System.Text.Json.Serialization.Metadata/DefaultJsonTypeInfoResolver.xml
index f57cee9eb6f..5aaec55fdcc 100644
--- a/xml/System.Text.Json.Serialization.Metadata/DefaultJsonTypeInfoResolver.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/DefaultJsonTypeInfoResolver.xml
@@ -18,8 +18,16 @@
- To be added.
- To be added.
+ Defines the default, reflection-based JSON contract resolver used by System.Text.Json.
+
+ .
+
+ ]]>
+
@@ -45,7 +53,7 @@
- To be added.
+ Creates a mutable instance.
To be added.
@@ -72,11 +80,22 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The type for which to resolve a JSON contract.
+ A instance used to determine contract configuration.
+ Resolves a JSON contract for a given and configuration.
+ A defining a reflection-derived JSON contract for .
+
+ list.
+
+ ]]>
+
+
+ or is .
@@ -95,9 +114,19 @@
System.Collections.Generic.IList<System.Action<System.Text.Json.Serialization.Metadata.JsonTypeInfo>>
- To be added.
+ Gets a list of user-defined callbacks that can be used to modify the initial contract.
To be added.
- To be added.
+
+ invocation.
+
+Modifier callbacks are called consecutively in the order in which they're specified in the list.
+
+ ]]>
+
diff --git a/xml/System.Text.Json.Serialization.Metadata/IJsonTypeInfoResolver.xml b/xml/System.Text.Json.Serialization.Metadata/IJsonTypeInfoResolver.xml
index abf4baf020d..386fe26cef5 100644
--- a/xml/System.Text.Json.Serialization.Metadata/IJsonTypeInfoResolver.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/IJsonTypeInfoResolver.xml
@@ -11,7 +11,7 @@
- To be added.
+ Used to resolve the JSON serialization contract for requested types.
To be added.
@@ -35,10 +35,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ Type to be resolved.
+ Configuration used when resolving the metadata.
+ Resolves a contract for the requested type and options.
+ A instance matching the requested type, or if no contract could be resolved.
To be added.
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
index b881b3f579d..de1216882a2 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
@@ -1453,11 +1453,19 @@ This API is for use by the output of the System.Text.Json source generator and s
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The generic definition for the underlying nullable type.
+ The to use for serialization and deserialization.
+ Creates a instance that converts values.
+ A instance that converts values
+
+
+
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml b/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml
index f3cf2686124..ee2222b9b64 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml
@@ -43,9 +43,21 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Text.Json.Serialization.JsonConverter
- To be added.
+ Gets or sets a custom converter override for the current property.
To be added.
- To be added.
+
+ instances with this property.
+
+For contracts originating from , the value of
+ will be mapped from annotations.
+
+ ]]>
+
+ The instance has been locked for further modification.
@@ -64,9 +76,18 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Func<System.Object,System.Object>
- To be added.
+ Gets or sets a getter delegate for the property.
To be added.
- To be added.
+
+
+
+ The instance has been locked for further modification.
@@ -85,9 +106,24 @@ This API is intended for use by the output of the System.Text.Json source genera
System.String
- To be added.
+ Gets or sets the JSON property name used when serializing the property.
To be added.
- To be added.
+
+ cannot conflict with that of other defined in the declaring .
+
+For contracts originating from or ,
+ the value typically reflects the underlying .NET member name, the name derived from ,
+ or the value specified in .
+
+ ]]>
+
+
+ is .
+ The instance has been locked for further modification.
@@ -106,9 +142,19 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Nullable<System.Text.Json.Serialization.JsonNumberHandling>
- To be added.
+ Gets or sets the applied to the current property.
To be added.
- To be added.
+
+ or ,
+ the value of this property will be mapped from annotations.
+
+ ]]>
+
+ The instance has been locked for further modification.
@@ -127,7 +173,7 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Text.Json.JsonSerializerOptions
- To be added.
+ Gets the value associated with the current contract instance.
To be added.
To be added.
@@ -148,7 +194,7 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Type
- To be added.
+ Gets the type of the current property.
To be added.
To be added.
@@ -169,9 +215,18 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Action<System.Object,System.Object>
- To be added.
+ Gets or sets a setter delegate for the property.
To be added.
- To be added.
+
+
+
+ The instance has been locked for further modification.
@@ -190,9 +245,23 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Func<System.Object,System.Object,System.Boolean>
- To be added.
+ Gets or sets a predicate that determines whether the current property value should be serialized.
To be added.
- To be added.
+
+ ,
+ the value of will map to this predicate.
+
+ ]]>
+
+ The instance has been locked for further modification.
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml
index 241cc45baeb..67acb9cfb79 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml
@@ -47,9 +47,19 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Text.Json.Serialization.JsonConverter
- To be added.
+ Gets the associated with the current type.
To be added.
- To be added.
+
+ associated with the type determines the value of ,
+ and by extension the types of metadata that are configurable in the current JSON contract.
+ As such, the value of the converter cannot be changed once a instance has been created.
+
+ ]]>
+
@@ -72,11 +82,15 @@ This API is intended for use by the output of the System.Text.Json source genera
- To be added.
- To be added.
- To be added.
- To be added.
+ The declared type for the property.
+ The property name used in JSON serialization and deserialization.
+ Creates a blank instance for the current .
+ A blank instance.
To be added.
+
+ or is .
+
+ cannot be used for serialization.
@@ -109,11 +123,30 @@ This API is intended for use by the output of the System.Text.Json source genera
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The type for which contract metadata is specified.
+ The instance the metadata is associated with.
+ Creates a blank instance.
+ A blank instance.
+
+ will be blank, with the exception of the
+ property which will be resolved either from
+ or the built-in converters for the type.
+ Any converters specified via on the type declaration
+ will not be resolved by this method.
+
+Which converter gets resolved influences the value of ,
+ which constrains the type of metadata that can be modified in the instance.
+
+ ]]>
+
+
+ or is .
+
+ cannot be used for serialization.
@@ -148,11 +181,28 @@ This API is intended for use by the output of the System.Text.Json source genera
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The type for which contract metadata is specified.
+ The instance the metadata is associated with.
+ Creates a blank instance.
+ A blank instance.
+
+ will be blank, with the exception of the
+ property, which will be resolved either from
+ or the built-in converters for the type.
+ Any converters specified via on the type declaration
+ will not be resolved by this method.
+
+Which converter gets resolved influences the value of ,
+ which constrains the type of metadata that can be modified in the instance.
+
+ ]]>
+
+
+ is .
@@ -171,9 +221,26 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Func<System.Object>
- To be added.
+ Gets or sets a parameterless factory to be used on deserialization.
To be added.
- To be added.
+
+ or ,
+ types with a single default constructor or default constructors annotated with
+ will be mapped to this delegate.
+
+ ]]>
+
+ The instance has been locked for further modification.
+
+-or-
+
+A parameterless factory is not supported for the current metadata .
@@ -192,9 +259,24 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Text.Json.Serialization.Metadata.JsonTypeInfoKind
- To be added.
+ Gets a value that describes the kind of contract metadata that the current instance specifies.
To be added.
- To be added.
+
+ determines what aspects of the JSON contract are configurable.
+ For example, it is only possible to configure the list for metadata
+ of kind .
+
+The value of is determined exclusively by the
+ resolved for the current type, and cannot be changed once resolution has happened.
+ User-defined custom converters (specified either via or )
+ are metadata-agnostic and thus always resolve to .
+
+ ]]>
+
@@ -213,9 +295,19 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Nullable<System.Text.Json.Serialization.JsonNumberHandling>
- To be added.
+ Gets or sets the type-level override.
To be added.
- To be added.
+
+ or ,
+ the value of this callback will be mapped from any annotations.
+
+ ]]>
+
+ The instance has been locked for further modification.
@@ -234,7 +326,7 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Text.Json.JsonSerializerOptions
- To be added.
+ Gets the value associated with the current instance.
To be added.
To be added.
@@ -255,9 +347,25 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Collections.Generic.IList<System.Text.Json.Serialization.Metadata.JsonPropertyInfo>
- To be added.
+ Gets the list of metadata corresponding to the current type.
To be added.
- To be added.
+
+ .
+ For other kinds, an empty, read-only list will be returned.
+
+The order of entries in the list determines the serialization order,
+ unless either of the entries specifies a non-zero value,
+ in which case the properties will be stable sorted by .
+
+It's required that added entries are unique up to ,
+ however this will only be validated on serialization, once the metadata instance gets locked for further modification.
+
+ ]]>
+
@@ -276,7 +384,7 @@ This API is intended for use by the output of the System.Text.Json source genera
System.Type
- To be added.
+ Gets the for which the JSON serialization contract is being defined.
To be added.
To be added.
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoKind.xml b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoKind.xml
index 94d5bcee06f..bee9fadb434 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoKind.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoKind.xml
@@ -13,7 +13,7 @@
System.Enum
- To be added.
+ Describes the kind of contract metadata a specifies.
To be added.
@@ -34,7 +34,7 @@
3
- To be added.
+ Type is serialized as a dictionary with key/value pair entries.
@@ -54,7 +54,7 @@
2
- To be added.
+ Type is serialized as a collection with elements.
@@ -74,7 +74,7 @@
0
- To be added.
+ Type is either a simple value or uses a custom converter.
@@ -94,7 +94,7 @@
1
- To be added.
+ Type is serialized as an object with properties.
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml
index ff8249bdcd0..436fcd24ec3 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml
@@ -14,7 +14,7 @@
- To be added.
+ Contains utilities and combinators acting on .
To be added.
@@ -44,10 +44,26 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ Sequence of contract resolvers to be queried for metadata.
+ Combines multiple sources into one.
+ A combining results from .
+
+ sources,
+ which typically define contract metadata for small subsets of types.
+ It can also be used to fall back to wherever necessary.
+
+ ]]>
+
+
+ or any of its elements is .
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo`1.xml b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo`1.xml
index 637d706f94b..021ad003de3 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo`1.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo`1.xml
@@ -39,9 +39,26 @@
System.Func<T>
- To be added.
+ Gets or sets a parameterless factory to be used on deserialization.
To be added.
- To be added.
+
+ or ,
+ types with a single default constructor or default constructors annotated with
+ will be mapped to this delegate.
+
+ ]]>
+
+ The instance has been locked for further modification.
+
+-or-
+
+A parameterless factory is not supported for the current metadata .
diff --git a/xml/System.Text.Json/JsonSerializerOptions.xml b/xml/System.Text.Json/JsonSerializerOptions.xml
index 1df53d32990..50726d97e30 100644
--- a/xml/System.Text.Json/JsonSerializerOptions.xml
+++ b/xml/System.Text.Json/JsonSerializerOptions.xml
@@ -850,9 +850,19 @@ Use to enable un
System.Text.Json.Serialization.Metadata.IJsonTypeInfoResolver
- To be added.
+ Gets or sets the contract resolver used by this instance.
To be added.
- To be added.
+
+ .
+ The property will be populated automatically once used with one of the methods.
+
+ ]]>
+
+ The property is set after serialization or deserialization has occurred.
diff --git a/xml/System/Decimal.xml b/xml/System/Decimal.xml
index 656a199d96c..8466ec2e579 100644
--- a/xml/System/Decimal.xml
+++ b/xml/System/Decimal.xml
@@ -3124,8 +3124,8 @@ For , this method matches the IE
- To be added.
- To be added.
+ The value that multiplies.
+ The value that multiplies .
Multiplies two values together to compute their product.
The product of divided-by .
To be added.
diff --git a/xml/System/Double.xml b/xml/System/Double.xml
index 2af4d967f03..33b02034d0a 100644
--- a/xml/System/Double.xml
+++ b/xml/System/Double.xml
@@ -591,7 +591,15 @@
To be added.
Computes the arc-cosine of a value.
The arc-cosine of .
- To be added.
+
+
+
@@ -657,9 +665,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-cosine of a value and divides the result by pi.
+ The arc-cosine of , divided by pi.
+
+
+
@@ -693,7 +709,15 @@
To be added.
Computes the arc-sine of a value.
The arc-sine of .
- To be added.
+
+
+
@@ -759,9 +783,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-sine of a value and divides the result by pi.
+ The arc-sine of , divided by pi.
+
+
+
@@ -795,7 +827,15 @@
To be added.
Computes the arc-tangent of a value.
The arc-tangent of .
- To be added.
+
+
+
@@ -831,7 +871,15 @@
To be added.
Computes the arc-tangent of the quotient of two values.
The arc-tangent of divided-by .
- To be added.
+
+
+
@@ -865,9 +913,17 @@
To be added.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent for the quotient of two values and divides the result by pi.
+ The arc-tangent of divided-by , divided by pi.
+
+
+
@@ -933,9 +989,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent of a value and divides the result by pi.
+ The arc-tangent of , divided by pi.
+
+
+
@@ -1386,7 +1450,15 @@
To be added.
Computes the cosine of a value.
The cosine of .
- To be added.
+
+
+
@@ -1452,9 +1524,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the cosine of a value that has been multipled by pi.
+ The cosine of multiplied-by pi.
+
+
+
@@ -2293,8 +2373,8 @@ Euler's number is approximately 2.7182818284590452354.
To be added.
To be added.
- To be added.
- To be added.
+ Computes the hypotenuse given two values representing the lengths of the shorter sides in a right-angled triangle.
+ The square root of -squared plus -squared.
To be added.
@@ -5449,7 +5529,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine of a value.
The sine of .
- To be added.
+
+
+
@@ -5489,7 +5577,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine and cosine of a value.
The sine and cosine of .
- To be added.
+
+
+
@@ -5555,9 +5651,17 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the sine of a value that has been multiplied by pi.
+ The sine of multiplied-by pi.
+
+
+
@@ -6815,7 +6919,15 @@ This member is an explicit interface member implementation. It can be used only
To be added.
Computes the tangent of a value.
The tangent of .
- To be added.
+
+
+
@@ -6881,9 +6993,17 @@ This member is an explicit interface member implementation. It can be used only
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the tangent of a value that has been multipled by pi.
+ The tangent of multiplied-by pi.
+
+
+
diff --git a/xml/System/GC.xml b/xml/System/GC.xml
index f5756e5a1a0..25377a2483b 100644
--- a/xml/System/GC.xml
+++ b/xml/System/GC.xml
@@ -1245,8 +1245,8 @@ This method is most useful in monitoring scenarios for measuring the difference
- To be added.
- To be added.
+ Gets the total amount of time paused in GC since the beginning of the process.
+ The total amount of time paused in GC since the beginning of the process.
To be added.
diff --git a/xml/System/Half.xml b/xml/System/Half.xml
index 927b8dd7484..36b46ef5e91 100644
--- a/xml/System/Half.xml
+++ b/xml/System/Half.xml
@@ -305,7 +305,15 @@ This is an IEEE 754-compliant `float16` type.
To be added.
Computes the arc-cosine of a value.
The arc-cosine of .
- To be added.
+
+
+
@@ -359,9 +367,17 @@ This is an IEEE 754-compliant `float16` type.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-cosine of a value and divides the result by pi.
+ The arc-cosine of , divided by pi.
+
+
+
@@ -389,7 +405,15 @@ This is an IEEE 754-compliant `float16` type.
To be added.
Computes the arc-sine of a value.
The arc-sine of .
- To be added.
+
+
+
@@ -443,9 +467,17 @@ This is an IEEE 754-compliant `float16` type.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-sine of a value and divides the result by pi.
+ The arc-sine of , divided by pi.
+
+
+
@@ -473,7 +505,15 @@ This is an IEEE 754-compliant `float16` type.
To be added.
Computes the arc-tangent of a value.
The arc-tangent of .
- To be added.
+
+
+
@@ -503,7 +543,15 @@ This is an IEEE 754-compliant `float16` type.
To be added.
Computes the arc-tangent of the quotient of two values.
The arc-tangent of divided-by .
- To be added.
+
+
+
@@ -531,9 +579,17 @@ This is an IEEE 754-compliant `float16` type.
To be added.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent for the quotient of two values and divides the result by pi.
+ The arc-tangent of divided-by , divided by pi.
+
+
+
@@ -587,9 +643,17 @@ This is an IEEE 754-compliant `float16` type.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent of a value and divides the result by pi.
+ The arc-tangent of , divided by pi.
+
+
+
@@ -863,7 +927,15 @@ This is an IEEE 754-compliant `float16` type.
To be added.
Computes the cosine of a value.
The cosine of .
- To be added.
+
+
+
@@ -917,9 +989,17 @@ This is an IEEE 754-compliant `float16` type.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the cosine of a value that has been multipled by pi.
+ The cosine of multiplied-by pi.
+
+
+
@@ -1327,8 +1407,8 @@ This is an IEEE 754-compliant `float16` type.
To be added.
To be added.
- To be added.
- To be added.
+ Computes the hypotenuse given two values representing the lengths of the shorter sides in a right-angled triangle.
+ The square root of -squared plus -squared.
To be added.
@@ -4536,7 +4616,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine of a value.
The sine of .
- To be added.
+
+
+
@@ -4570,7 +4658,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine and cosine of a value.
The sine and cosine of .
- To be added.
+
+
+
@@ -4624,9 +4720,17 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the sine of a value that has been multiplied by pi.
+ The sine of multiplied-by pi.
+
+
+
@@ -4906,7 +5010,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the tangent of a value.
The tangent of .
- To be added.
+
+
+
@@ -4960,9 +5072,17 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the tangent of a value that has been multipled by pi.
+ The tangent of multiplied-by pi.
+
+
+
diff --git a/xml/System/Int128.xml b/xml/System/Int128.xml
index 228155cedf6..97ff47d5639 100644
--- a/xml/System/Int128.xml
+++ b/xml/System/Int128.xml
@@ -2972,11 +2972,11 @@ This operation is meant to perform n unsigned (otherwise known as a logical) rig
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The string to parse.
+ A bitwise combination of number styles that can be present in .
+ An object that provides culture-specific formatting information about .
+ Parses a string into a value.
+ The result of parsing .
To be added.
diff --git a/xml/System/ObjectDisposedException.xml b/xml/System/ObjectDisposedException.xml
index 885e8846945..4aae5b03567 100644
--- a/xml/System/ObjectDisposedException.xml
+++ b/xml/System/ObjectDisposedException.xml
@@ -499,10 +499,11 @@ Caught:
- To be added.
- To be added.
- To be added.
+ The condition to evaluate.
+ The object whose type's full name should be included in any resulting .
+ Throws an if the specified is .
To be added.
+ The is .
@@ -538,10 +539,11 @@ Caught:
- To be added.
- To be added.
- To be added.
+ The condition to evaluate.
+ The type whose full name should be included in any resulting .
+ Throws an if the specified is .
To be added.
+ The is .
diff --git a/xml/System/Single.xml b/xml/System/Single.xml
index 55d0fd57943..c8bb79f51f6 100644
--- a/xml/System/Single.xml
+++ b/xml/System/Single.xml
@@ -589,7 +589,15 @@
To be added.
Computes the arc-cosine of a value.
The arc-cosine of .
- To be added.
+
+
+
@@ -655,9 +663,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-cosine of a value and divides the result by pi.
+ The arc-cosine of , divided by pi.
+
+
+
@@ -691,7 +707,15 @@
To be added.
Computes the arc-sine of a value.
The arc-sine of .
- To be added.
+
+
+
@@ -757,9 +781,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-sine of a value and divides the result by pi.
+ The arc-sine of , divided by pi.
+
+
+
@@ -793,7 +825,15 @@
To be added.
Computes the arc-tangent of a value.
The arc-tangent of .
- To be added.
+
+
+
@@ -829,7 +869,15 @@
To be added.
Computes the arc-tangent of the quotient of two values.
The arc-tangent of divided-by .
- To be added.
+
+
+
@@ -863,9 +911,17 @@
To be added.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent for the quotient of two values and divides the result by pi.
+ The arc-tangent of divided-by , divided by pi.
+
+
+
@@ -931,9 +987,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the arc-tangent of a value and divides the result by pi.
+ The arc-tangent of , divided by pi.
+
+
+
@@ -1384,7 +1448,15 @@
To be added.
Computes the cosine of a value.
The cosine of .
- To be added.
+
+
+
@@ -1450,9 +1522,17 @@
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the cosine of a value that has been multipled by pi.
+ The cosine of multiplied-by pi.
+
+
+
@@ -2305,8 +2385,8 @@ This is known as Euler's number and is approximately 2.7182818284590452354.
To be added.
To be added.
- To be added.
- To be added.
+ Computes the hypotenuse given two values representing the lengths of the shorter sides in a right-angled triangle.
+ The square root of -squared plus -squared.
To be added.
@@ -5471,7 +5551,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine of a value.
The sine of .
- To be added.
+
+
+
@@ -5511,7 +5599,15 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
Computes the sine and cosine of a value.
The sine and cosine of .
- To be added.
+
+
+
@@ -5577,9 +5673,17 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively.
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the sine of a value that has been multiplied by pi.
+ The sine of multiplied-by pi.
+
+
+
@@ -6837,7 +6941,15 @@ This member is an explicit interface member implementation. It can be used only
To be added.
Computes the tangent of a value.
The tangent of .
- To be added.
+
+
+
@@ -6903,9 +7015,17 @@ This member is an explicit interface member implementation. It can be used only
To be added.
- To be added.
- To be added.
- To be added.
+ Computes the tangent of a value that has been multipled by pi.
+ The tangent of multiplied-by pi.
+
+
+
diff --git a/xml/System/UInt128.xml b/xml/System/UInt128.xml
index dc49758d759..44e29b6248d 100644
--- a/xml/System/UInt128.xml
+++ b/xml/System/UInt128.xml
@@ -2873,11 +2873,11 @@ This operation is meant to perform n unsigned (otherwise known as a logical) rig
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The string to parse.
+ A bitwise combination of number styles that can be present in .
+ An object that provides culture-specific formatting information about .
+ Parses a string into a value.
+ The result of parsing .
To be added.