Merge pull request #4296 from dotnet/publish-2144

BillWagner · web-flow · commit 2356e9c80b32 · 2020-05-28T06:29:00.000-04:00
Merge master into live
diff --git a/xml/Microsoft.Extensions.Configuration/ConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/ConfigurationExtensions.xml
@@ -25,7 +25,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Extension methods for configuration classes./&gt;.</summary>
+    <summary>Extension methods for configuration classes.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml
@@ -1087,7 +1087,8 @@ handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousA
 
 ## Remarks
  Set this property to `true` when requests made by the <xref:System.Net.Http.HttpClientHandler> object should, if requested by the server, be authenticated using the credentials of the currently logged on user. For client applications, this is the desired behavior in most scenarios. For middle-tier applications, such as ASP.NET applications, instead of using this property, you would typically set the <xref:System.Net.Http.HttpClientHandler.Credentials%2A> property to the credentials of the client on whose behalf the request is made.
-
+ 
+ This property doesn't affect proxy credentials. When the default (system) proxy is being used, set credentials explicitly by using the <xref:System.Net.Http.HttpClientHandler.DefaultProxyCredentials> property. When the proxy is set by the <xref:System.Net.Http.HttpClientHandler.Proxy> property, set credentials for the proxy via its <xref:System.Net.IWebProxy.Credentials> property.
  ]]></format>
         </remarks>
       </Docs>
diff --git a/xml/System.Threading/EventWaitHandleAcl.xml b/xml/System.Threading/EventWaitHandleAcl.xml
@@ -1,4 +1,4 @@
-<Type Name="EventWaitHandleAcl" FullName="System.Threading.EventWaitHandleAcl">
+﻿<Type Name="EventWaitHandleAcl" FullName="System.Threading.EventWaitHandleAcl">
   <TypeSignature Language="C#" Value="public static class EventWaitHandleAcl" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract sealed beforefieldinit EventWaitHandleAcl extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Threading.EventWaitHandleAcl" />
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a Windows-specific extension method for creating <see cref="T:System.Threading.EventWaitHandle" /> objects with specific access control list (ACL) security.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Threading/MutexAcl.xml b/xml/System.Threading/MutexAcl.xml
@@ -1,4 +1,4 @@
-<Type Name="MutexAcl" FullName="System.Threading.MutexAcl">
+﻿<Type Name="MutexAcl" FullName="System.Threading.MutexAcl">
   <TypeSignature Language="C#" Value="public static class MutexAcl" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract sealed beforefieldinit MutexAcl extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Threading.MutexAcl" />
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a Windows-specific extension method for creating <see cref="T:System.Threading.Mutex" /> objects with specific access control list (ACL) security.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Threading/SemaphoreAcl.xml b/xml/System.Threading/SemaphoreAcl.xml
@@ -1,4 +1,4 @@
-<Type Name="SemaphoreAcl" FullName="System.Threading.SemaphoreAcl">
+﻿<Type Name="SemaphoreAcl" FullName="System.Threading.SemaphoreAcl">
   <TypeSignature Language="C#" Value="public static class SemaphoreAcl" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract sealed beforefieldinit SemaphoreAcl extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Threading.SemaphoreAcl" />
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a Windows-specific extension method for creating <see cref="T:System.Threading.Semaphore" /> objects with specific access control list (ACL) security.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Threading/ThreadingAclExtensions.xml b/xml/System.Threading/ThreadingAclExtensions.xml
@@ -24,7 +24,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides Windows-specific extension methods for managing the access control list (ACL) security descriptors for <see cref="T:System.Threading.EventWaitHandle" />, <see cref="T:System.Threading.Mutex" />, and <see cref="T:System.Threading.Semaphore" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -52,9 +52,9 @@
         <Parameter Name="handle" Type="System.Threading.EventWaitHandle" RefType="this" />
       </Parameters>
       <Docs>
-        <param name="handle">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="handle">The event wait handle from which the security descriptors should be returned.</param>
+        <summary>Returns the security descriptors for the specified <paramref name="handle" />.</summary>
+        <returns>The security descriptors for the specified <paramref name="handle" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -82,9 +82,9 @@
         <Parameter Name="mutex" Type="System.Threading.Mutex" RefType="this" />
       </Parameters>
       <Docs>
-        <param name="mutex">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="mutex">The mutex from which the security descriptors should be returned.</param>
+        <summary>Returns the security descriptors for the specified <paramref name="mutex" />.</summary>
+        <returns>The security descriptors for the specified <paramref name="mutex" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -112,9 +112,9 @@
         <Parameter Name="semaphore" Type="System.Threading.Semaphore" RefType="this" />
       </Parameters>
       <Docs>
-        <param name="semaphore">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="semaphore">The semaphore from which the security descriptors should be returned.</param>
+        <summary>Returns the security descriptors for the specified <paramref name="semaphore" />.</summary>
+        <returns>The security descriptors for the specified semaphore.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -143,10 +143,12 @@
         <Parameter Name="eventSecurity" Type="System.Security.AccessControl.EventWaitHandleSecurity" />
       </Parameters>
       <Docs>
-        <param name="handle">To be added.</param>
-        <param name="eventSecurity">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="handle">The event wait handle onto which the <paramref name="eventSecurity" /> will be applied.</param>
+        <param name="eventSecurity">The security descriptors to apply to the specified <paramref name="handle" />.</param>
+        <summary>Sets the security descriptors for the specified event wait handle.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="eventSecurity" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetAccessControl">
@@ -174,10 +176,12 @@
         <Parameter Name="mutexSecurity" Type="System.Security.AccessControl.MutexSecurity" />
       </Parameters>
       <Docs>
-        <param name="mutex">To be added.</param>
-        <param name="mutexSecurity">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="mutex">The mutex onto which the <paramref name="mutexSecurity" /> will be applied.</param>
+        <param name="mutexSecurity">The security descriptors to apply to the specified <paramref name="mutex" />.</param>
+        <summary>Sets the security descriptors for the specified mutex.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="mutexSecurity" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetAccessControl">
@@ -205,10 +209,12 @@
         <Parameter Name="semaphoreSecurity" Type="System.Security.AccessControl.SemaphoreSecurity" />
       </Parameters>
       <Docs>
-        <param name="semaphore">To be added.</param>
-        <param name="semaphoreSecurity">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="semaphore">The semaphore onto which the <paramref name="semaphoreSecurity" /> will be applied.</param>
+        <param name="semaphoreSecurity">The security descriptors to apply to the specified <paramref name="semaphore" />.</param>
+        <summary>Sets the security descriptors for the specified semaphore.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="semaphoreSecurity" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Windows/Application.xml b/xml/System.Windows/Application.xml
@@ -333,7 +333,7 @@
         <ReturnType>System.Windows.ExitEventHandler</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Occurs just before an application shuts down, and cannot be canceled.</summary>
+        <summary>Occurs just before an application shuts down and cannot be canceled.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System/String.xml b/xml/System/String.xml
@@ -99,7 +99,7 @@
 
  A string is a sequential collection of characters that is used to represent text. A <xref:System.String> object is a sequential collection of <xref:System.Char?displayProperty=nameWithType> objects that represent a string; a <xref:System.Char?displayProperty=nameWithType> object corresponds to a UTF-16 code unit. The value of the <xref:System.String> object is the content of the sequential collection of <xref:System.Char?displayProperty=nameWithType> objects, and that value is immutable (that is, it is read-only). For more information about the immutability of strings, see the [Immutability and the StringBuilder class](#Immutability) section later in this topic. The maximum size of a <xref:System.String> object in memory is 2GB, or about 1 billion characters.
 
-For more information about Unicode, UTF-16, code units, code points, and the <xref:System.Char> and <xref:System.Text.Rune> types, see [Introduction to character encoding in .NET](~/docs/dotnet/standard/base-types/character-encoding-introduction.md).
+For more information about Unicode, UTF-16, code units, code points, and the <xref:System.Char> and <xref:System.Text.Rune> types, see [Introduction to character encoding in .NET](/dotnet/standard/base-types/character-encoding-introduction).
 
  In this section:
 
@@ -225,7 +225,7 @@ For more information about Unicode, UTF-16, code units, code points, and the <xr
 
  This example works with text elements by using the <xref:System.Globalization.StringInfo.GetTextElementEnumerator%2A?displayProperty=nameWithType> method and the <xref:System.Globalization.TextElementEnumerator> class to enumerate all the text elements in a string. You can also retrieve an array that contains the starting index of each text element by calling the <xref:System.Globalization.StringInfo.ParseCombiningCharacters%2A?displayProperty=nameWithType> method.
 
- For more information about working with units of text rather than individual <xref:System.Char> values, see [Introduction to character encoding in .NET](~/docs/dotnet/standard/base-types/character-encoding-introduction.md).
+ For more information about working with units of text rather than individual <xref:System.Char> values, see [Introduction to character encoding in .NET](/dotnet/standard/base-types/character-encoding-introduction).
 
 <a name="Nulls"></a>
 ## Null strings and empty strings
