Intellisense fixes (#4133)

* intellisense fixes

* additional fixes

* feedback

Author: mairaw

xml/Microsoft.Extensions.Configuration.AzureKeyVault/AzureKeyVaultConfigurationOptions.xml

@@ -172,7 +172,7 @@
         <ReturnType>System.Nullable&lt;System.TimeSpan&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets the timespan to wait between attempts at polling the Azure KeyVault for changes. <code>null</code> to disable reloading.</summary>
+        <summary>Gets or sets the timespan to wait between attempts at polling the Azure KeyVault for changes. <see langword="null" /> to disable reloading.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Configuration.AzureKeyVault/IKeyVaultSecretManager.xml

@@ -77,7 +77,7 @@
         <param name="secret">The <see cref="T:Microsoft.Azure.KeyVault.Models.SecretItem" /> instance.</param>
         <summary>Checks if <see cref="T:Microsoft.Azure.KeyVault.Models.SecretItem" /> value should be retrieved.</summary>
         <returns>
-          <code>true</code> is secrets value should be loaded, otherwise <code>false</code>.</returns>
+          <see langword="true" /> is secrets value should be loaded, otherwise <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

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

@@ -62,7 +62,7 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Disables colors when <code>true</code>.</summary>
+        <summary>Disables colors when <see langword="true" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -109,7 +109,7 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Includes scopes when <code>true</code>.</summary>
+        <summary>Includes scopes when <see langword="true" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Logging/EventId.xml

@@ -77,7 +77,7 @@
         <param name="other">An object to compare with this object.</param>
         <summary>Indicates whether the current object is equal to another object of the same type. Two events are equal if they have the same id.</summary>
         <returns>
-          <code>true</code> if the current object is equal to the other parameter; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the current object is equal to the other parameter; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -217,7 +217,7 @@
         <param name="right">The second <see cref="T:Microsoft.Extensions.Logging.EventId" />.</param>
         <summary>Checks if two specified <see cref="T:Microsoft.Extensions.Logging.EventId" /> instances have the same value. They are equal if they have the same Id.</summary>
         <returns>
-          <code>true</code> if the objects are equal.</returns>
+          <see langword="true" /> if the objects are equal.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -279,7 +279,7 @@
         <param name="right">The second <see cref="T:Microsoft.Extensions.Logging.EventId" />.</param>
         <summary>Checks if two specified <see cref="T:Microsoft.Extensions.Logging.EventId" /> instances have different values.</summary>
         <returns>
-          <code>true</code> if the objects are not equal.</returns>
+          <see langword="true" /> if the objects are not equal.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.Extensions.ObjectPool/IPooledObjectPolicy`1.xml

@@ -81,7 +81,7 @@
         <param name="obj">The object to return to the pool.</param>
         <summary>Runs some processing when an object was returned to the pool. Can be used to reset the state of an object and indicate if the object should be returned to the pool.</summary>
         <returns>
-          <code>true</code> if the object should be returned to the pool. <code>false</code> if it's not possible/desirable for the pool to keep the object.</returns>
+          <see langword="true" /> if the object should be returned to the pool. <see langword="false" /> if it's not possible/desirable for the pool to keep the object.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.Extensions.Primitives/StringSegment.xml

@@ -98,7 +98,7 @@
         <summary>Initializes an instance of the <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> struct.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="buffer" /> is <code>null</code>.
+          <paramref name="buffer" /> is <see langword="null" />.
             </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="offset" /> or <paramref name="length" /> is less than zero, or <paramref name="offset" /> +
@@ -279,10 +279,10 @@
         <param name="comparisonType">One of the enumeration values that specifies the rules to use in the comparison.</param>
         <summary>Checks if the end of this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> matches the specified <see cref="T:System.String" /> when compared using the specified <paramref name="comparisonType" />.</summary>
         <returns>
-          <code>true</code> if <paramref name="text" /> matches the end of this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if <paramref name="text" /> matches the end of this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="text" /> is <code>null</code>.
+          <paramref name="text" /> is <see langword="null" />.
             </exception>
       </Docs>
     </Member>
@@ -318,7 +318,7 @@
         <param name="other">An object to compare with this object.</param>
         <summary>Indicates whether the current object is equal to another object of the same type.</summary>
         <returns>
-          <code>true</code> if the current object is equal to the other parameter; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the current object is equal to the other parameter; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -387,7 +387,7 @@
         <param name="text">The <see cref="T:System.String" /> to compare with the current <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />.</param>
         <summary>Checks if the specified <see cref="T:System.String" /> is equal to the current <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />.</summary>
         <returns>
-          <code>true</code> if the specified <see cref="T:System.String" /> is equal to the current <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the specified <see cref="T:System.String" /> is equal to the current <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -422,7 +422,7 @@
         <param name="comparisonType">One of the enumeration values that specifies the rules to use in the comparison.</param>
         <summary>Indicates whether the current object is equal to another object of the same type.</summary>
         <returns>
-          <code>true</code> if the current object is equal to the other parameter; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the current object is equal to the other parameter; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -457,10 +457,10 @@
         <param name="comparisonType">One of the enumeration values that specifies the rules to use in the comparison.</param>
         <summary>Checks if the specified <see cref="T:System.String" /> is equal to the current <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />.</summary>
         <returns>
-          <code>true</code> if the specified <see cref="T:System.String" /> is equal to the current <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the specified <see cref="T:System.String" /> is equal to the current <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="text" /> is <code>null</code>.
+          <paramref name="text" /> is <see langword="null" />.
             </exception>
       </Docs>
     </Member>
@@ -496,7 +496,7 @@
         <summary>Determines whether two specified <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> objects have the same value. A parameter specifies the culture, case, and
             sort rules used in the comparison.</summary>
         <returns>
-          <code>true</code> if the objects are equal; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the objects are equal; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -776,7 +776,7 @@
             was found; -1 if no character in <paramref name="anyOf" /> was found.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="anyOf" /> is <code>null</code>.
+          <paramref name="anyOf" /> is <see langword="null" />.
             </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="startIndex" /> or <paramref name="count" /> is less than zero, or <paramref name="startIndex" /> + <paramref name="count" /> is
@@ -960,11 +960,11 @@
         <Parameter Name="right" Type="Microsoft.Extensions.Primitives.StringSegment" />
       </Parameters>
       <Docs>
-        <param name="left">The first <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <code>null</code>.</param>
-        <param name="right">The second <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <code>null</code>.</param>
+        <param name="left">The first <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <see langword="null" />.</param>
+        <param name="right">The second <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <see langword="null" />.</param>
         <summary>Checks if two specified <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> have the same value.</summary>
         <returns>
-          <code>true</code> if the value of <paramref name="left" /> is the same as the value of <paramref name="right" />; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the value of <paramref name="left" /> is the same as the value of <paramref name="right" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1083,11 +1083,11 @@
         <Parameter Name="right" Type="Microsoft.Extensions.Primitives.StringSegment" />
       </Parameters>
       <Docs>
-        <param name="left">The first <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <code>null</code>.</param>
-        <param name="right">The second <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <code>null</code>.</param>
+        <param name="left">The first <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <see langword="null" />.</param>
+        <param name="right">The second <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> to compare, or <see langword="null" />.</param>
         <summary>Checks if two specified <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> have different values.</summary>
         <returns>
-          <code>true</code> if the value of <paramref name="left" /> is different from the value of <paramref name="right" />; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if the value of <paramref name="left" /> is different from the value of <paramref name="right" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1154,10 +1154,10 @@
         <param name="comparisonType">One of the enumeration values that specifies the rules to use in the comparison.</param>
         <summary>Checks if the beginning of this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> matches the specified <see cref="T:System.String" /> when compared using the specified <paramref name="comparisonType" />.</summary>
         <returns>
-          <code>true</code> if <paramref name="text" /> matches the beginning of this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <code>false</code>.</returns>
+          <see langword="true" /> if <paramref name="text" /> matches the beginning of this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="text" /> is <code>null</code>.
+          <paramref name="text" /> is <see langword="null" />.
             </exception>
       </Docs>
     </Member>
@@ -1334,8 +1334,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Returns the <see cref="T:System.String" /> represented by this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> or <code>String.Empty</code> if the <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> does not contain a value.</summary>
-        <returns>The <see cref="T:System.String" /> represented by this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> or <code>String.Empty</code> if the <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> does not contain a value.</returns>
+        <summary>Returns the <see cref="T:System.String" /> represented by this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> or <see cref="F:System.String.Empty" /> if the <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> does not contain a value.</summary>
+        <returns>The <see cref="T:System.String" /> represented by this <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> or <see cref="F:System.String.Empty" /> if the <see cref="T:Microsoft.Extensions.Primitives.StringSegment" /> does not contain a value.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.IO.Pipes/PipesAclExtensions.xml

@@ -86,10 +86,10 @@
         <param name="pipeSecurity">The security information to apply to the pipe stream.</param>
         <summary>Changes the security attributes of an existing pipe stream.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="System.ArgumentNullException">
+        <exception cref="T:System.ArgumentNullException">
           <paramref name="pipeSecurity" /> is <see langword="null" />.
         </exception>
-        <exception cref="System.IO.IOException">
+        <exception cref="T:System.IO.IOException">
           <paramref name="stream" /> is a disconnected <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> instance.
         </exception>
       </Docs>

xml/System.Reflection.Metadata.Ecma335/InstructionEncoder.xml

@@ -112,7 +112,7 @@
       </Parameters>
       <Docs>
         <param name="methodHandle">To be added.</param>
-        <summary>Encodes <code>call</code> instruction and its operand.</summary>
+        <summary>Encodes <c>call</c> instruction and its operand.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -141,7 +141,7 @@
       </Parameters>
       <Docs>
         <param name="methodHandle">To be added.</param>
-        <summary>Encodes <code>call</code> instruction and its operand.</summary>
+        <summary>Encodes <c>call</c> instruction and its operand.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -170,7 +170,7 @@
       </Parameters>
       <Docs>
         <param name="methodHandle">To be added.</param>
-        <summary>Encodes <code>call</code> instruction and its operand.</summary>
+        <summary>Encodes <c>call</c> instruction and its operand.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -199,7 +199,7 @@
       </Parameters>
       <Docs>
         <param name="methodHandle">To be added.</param>
-        <summary>Encodes <code>call</code> instruction and its operand.</summary>
+        <summary>Encodes <c>call</c> instruction and its operand.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -228,7 +228,7 @@
       </Parameters>
       <Docs>
         <param name="signature">To be added.</param>
-        <summary>Encodes <code>calli</code> instruction and its operand.</summary>
+        <summary>Encodes <c>calli</c> instruction and its operand.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -576,7 +576,7 @@ If `null` the encoder doesn't support construction of control flow.
       </Parameters>
       <Docs>
         <param name="handle">To be added.</param>
-        <summary>Encodes <code>ldstr</code> instruction and its operand.</summary>
+        <summary>Encodes <c>ldstr</c> instruction and its operand.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml

@@ -372,9 +372,7 @@ After `Fault` has been called on a dataflow block, that block will complete, suc
         <param name="messageConsumed">
           <see langword="true" /> if the message was successfully consumed. <see langword="false" /> otherwise.</param>
         <summary>Passes the ownership of the message identified by the <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader" /> from this  <see cref="T:System.Threading.Tasks.Dataflow.ISourceBlock`1" /> instance to the <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1" />.</summary>
-        <returns> The value of the consumed message. This may correspond to a different <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader" /> instance than was previously reserved and passed as the <paramref name="messageHeader" /> to <see cref="M:ConsumeMessage" />. The consuming <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1" /> must use the returned value instead of the value passed as messageValue through <see cref="M:OfferMessage" />.
-  If the message requested is not available, the return value will be <see langword="null" /> (Nothing in Visual Basic).
- </returns>
+        <returns>The value of the consumed message. This may correspond to a different <see cref="T:System.Threading.Tasks.Dataflow.DataflowMessageHeader" /> instance than was previously reserved and passed as the <paramref name="messageHeader" /> to <see cref="M:ConsumeMessage" />. The consuming <see cref="T:System.Threading.Tasks.Dataflow.ITargetBlock`1" /> must use the returned value instead of the value passed as messageValue through <c>OfferMessage</c>. If the message requested is not available, the return value will be <see langword="null" /> (Nothing in Visual Basic).</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[