updating inline <code> to <c> (#17611)

* updating inline "code" tag to "c" tag

* Apply suggestions from code review

Co-Authored-By: Andrew Stanton-Nurse <[email protected]>

* reverting tag

* reverting tag

* reverting entire file

Author: eddynaka

src/Components/Components/src/BindElementAttribute.cs

@@ -1,4 +1,4 @@
-// Copyright (c) .NET Foundation. All rights reserved.
+// Copyright (c) .NET Foundation. All rights reserved.
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 
 using System;
@@ -15,7 +15,7 @@ public sealed class BindElementAttribute : Attribute
         /// Constructs an instance of <see cref="BindElementAttribute"/>.
         /// </summary>
         /// <param name="element">The tag name of the element.</param>
-        /// <param name="suffix">The suffix value. For example, set this to <code>value</code> for <code>bind-value</code>, or set this to <code>null</code> for <code>bind</code>.</param>
+        /// <param name="suffix">The suffix value. For example, set this to <c>value</c> for <c>bind-value</c>, or set this to <see langword="null" /> for <c>bind</c>.</param>
         /// <param name="valueAttribute">The name of the value attribute to be bound.</param>
         /// <param name="changeAttribute">The name of an attribute that will register an associated change event.</param>
         public BindElementAttribute(string element, string suffix, string valueAttribute, string changeAttribute)
@@ -47,7 +47,7 @@ public BindElementAttribute(string element, string suffix, string valueAttribute
 
         /// <summary>
         /// Gets the suffix value.
-        /// For example, this will be <code>value</code> to mean <code>bind-value</code>, or <code>null</code> to mean <code>bind</code>.
+        /// For example, this will be <c>value</c> to mean <c>bind-value</c>, or <see langword="null" /> to mean <c>bind</c>.
         /// </summary>
         public string Suffix { get; }
 

src/Components/Web/src/BindInputElementAttribute.cs

@@ -7,15 +7,15 @@
 namespace Microsoft.AspNetCore.Components
 {
     /// <summary>
-    /// Configures options for binding subtypes of an HTML <code>input</code> element.
+    /// Configures options for binding subtypes of an HTML <c>input</c> element.
     /// </summary>
     [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = true)]
     public sealed class BindInputElementAttribute : Attribute
     {
         /// <summary>
         /// Constructs an instance of <see cref="BindInputElementAttribute"/>.
         /// </summary>
-        /// <param name="type">The value of the element's <code>type</code> attribute.</param>
+        /// <param name="type">The value of the element's <c>type</c> attribute.</param>
         /// <param name="suffix">The suffix value.</param>
         /// <param name="valueAttribute">The name of the value attribute to be bound.</param>
         /// <param name="changeAttribute">The name of an attribute that will register an associated change event.</param>
@@ -46,7 +46,7 @@ public BindInputElementAttribute(string type, string suffix, string valueAttribu
         }
 
         /// <summary>
-        /// Gets the value of the element's <code>type</code> attribute.
+        /// Gets the value of the element's <c>type</c> attribute.
         /// </summary>
         public string Type { get; }
 

src/Http/Authentication.Abstractions/src/IAuthenticationRequestHandler.cs

@@ -13,7 +13,7 @@ public interface IAuthenticationRequestHandler : IAuthenticationHandler
         /// <summary>
         /// Returns true if request processing should stop.
         /// </summary>
-        /// <returns><code>true</code> if request processing should stop.</returns>
+        /// <returns><see langword="true" /> if request processing should stop.</returns>
         Task<bool> HandleRequestAsync();
     }
 

src/Http/Headers/src/HeaderUtilities.cs

@@ -230,8 +230,8 @@ private static int AdvanceCacheDirectiveIndex(int current, string headerValue)
         /// any value originally supplied in result will be overwritten.
         /// </param>
         /// <returns>
-        /// <code>true</code> if <paramref name="targetValue"/> is found and successfully parsed; otherwise,
-        /// <code>false</code>.
+        /// <see langword="true" /> if <paramref name="targetValue"/> is found and successfully parsed; otherwise,
+        /// <see langword="false" />.
         /// </returns>
         // e.g. { "headerValue=10, targetHeaderValue=30" }
         public static bool TryParseSeconds(StringValues headerValues, string targetValue, out TimeSpan? value)
@@ -286,8 +286,8 @@ public static bool TryParseSeconds(StringValues headerValues, string targetValue
         /// The target cache control directives to look for.
         /// </param>
         /// <returns>
-        /// <code>true</code> if <paramref name="targetDirectives"/> is contained in <paramref name="cacheControlDirectives"/>;
-        /// otherwise, <code>false</code>.
+        /// <see langword="true" /> if <paramref name="targetDirectives"/> is contained in <paramref name="cacheControlDirectives"/>;
+        /// otherwise, <see langword="false" />.
         /// </returns>
         public static bool ContainsCacheDirective(StringValues cacheControlDirectives, string targetDirectives)
         {
@@ -367,7 +367,7 @@ private static unsafe bool TryParseNonNegativeInt64FromHeaderValue(int startInde
         /// greater than Int64.MaxValue. This parameter is passed uninitialized; any value originally supplied in
         /// result will be overwritten.
         /// </param>
-        /// <returns><code>true</code> if parsing succeeded; otherwise, <code>false</code>.</returns>
+        /// <returns><see langword="true" /> if parsing succeeded; otherwise, <see langword="false" />.</returns>
         public static unsafe bool TryParseNonNegativeInt32(StringSegment value, out int result)
         {
             if (string.IsNullOrEmpty(value.Buffer) || value.Length == 0)
@@ -418,7 +418,7 @@ public static unsafe bool TryParseNonNegativeInt32(StringSegment value, out int
         /// represents a number greater than Int64.MaxValue. This parameter is passed uninitialized; any value
         /// originally supplied in result will be overwritten.
         /// </param>
-        /// <returns><code>true</code> if parsing succeeded; otherwise, <code>false</code>.</returns>
+        /// <returns><see langword="true" /> if parsing succeeded; otherwise, <see langword="false" />.</returns>
         public static unsafe bool TryParseNonNegativeInt64(StringSegment value, out long result)
         {
             if (string.IsNullOrEmpty(value.Buffer) || value.Length == 0)

src/Http/Http.Abstractions/src/HostString.cs

@@ -223,7 +223,7 @@ public static HostString FromUriComponent(Uri uri)
         /// "abc.example.com:443" but not "example.com:443".
         /// Matching is case insensitive.
         /// </remarks>
-        /// <returns><code>true</code> if <paramref name="value"/> matches any of the patterns.</returns>
+        /// <returns><see langword="true" /> if <paramref name="value"/> matches any of the patterns.</returns>
         public static bool MatchesAny(StringSegment value, IList<StringSegment> patterns)
         {
             if (value == null)
@@ -282,7 +282,7 @@ public static bool MatchesAny(StringSegment value, IList<StringSegment> patterns
         /// Compares the equality of the Value property, ignoring case.
         /// </summary>
         /// <param name="other">The <see cref="HostString"/> to compare against.</param>
-        /// <returns><code>true</code> if they have the same value.</returns>
+        /// <returns><see langword="true" /> if they have the same value.</returns>
         public bool Equals(HostString other)
         {
             if (!HasValue && !other.HasValue)
@@ -296,7 +296,7 @@ public bool Equals(HostString other)
         /// Compares against the given object only if it is a HostString.
         /// </summary>
         /// <param name="obj">The <see cref="object"/> to compare against.</param>
-        /// <returns><code>true</code> if they have the same value.</returns>
+        /// <returns><see langword="true" /> if they have the same value.</returns>
         public override bool Equals(object obj)
         {
             if (ReferenceEquals(null, obj))
@@ -320,7 +320,7 @@ public override int GetHashCode()
         /// </summary>
         /// <param name="left">The left parameter.</param>
         /// <param name="right">The right parameter.</param>
-        /// <returns><code>true</code> if both <see cref="HostString"/>'s have the same value.</returns>
+        /// <returns><see langword="true" /> if both <see cref="HostString"/>'s have the same value.</returns>
         public static bool operator ==(HostString left, HostString right)
         {
             return left.Equals(right);
@@ -331,7 +331,7 @@ public override int GetHashCode()
         /// </summary>
         /// <param name="left">The left parameter.</param>
         /// <param name="right">The right parameter.</param>
-        /// <returns><code>true</code> if both <see cref="HostString"/>'s values are not equal.</returns>
+        /// <returns><see langword="true" /> if both <see cref="HostString"/>'s values are not equal.</returns>
         public static bool operator !=(HostString left, HostString right)
         {
             return !left.Equals(right);

src/Http/Http.Extensions/src/RequestHeaders.cs

@@ -282,7 +282,7 @@ public Uri Referer
         /// <summary>
         /// Gets the value of header with <paramref name="name"/>.
         /// </summary>
-        /// <remarks><typeparamref name="T"/> must contain a TryParse method with the signature <code>public static bool TryParse(string, out T)</code>.</remarks>
+        /// <remarks><typeparamref name="T"/> must contain a TryParse method with the signature <c>public static bool TryParse(string, out T)</c>.</remarks>
         /// <typeparam name="T">The type of the header.
         /// The given type must have a static TryParse method.</typeparam>
         /// <param name="name">The name of the header to retrieve.</param>
@@ -295,7 +295,7 @@ public T Get<T>(string name)
         /// <summary>
         /// Gets the values of header with <paramref name="name"/>.
         /// </summary>
-        /// <remarks><typeparamref name="T"/> must contain a TryParseList method with the signature <code>public static bool TryParseList(IList&lt;string&gt;, out IList&lt;T&gt;)</code>.</remarks>
+        /// <remarks><typeparamref name="T"/> must contain a TryParseList method with the signature <c>public static bool TryParseList(IList&lt;string&gt;, out IList&lt;T&gt;)</c>.</remarks>
         /// <typeparam name="T">The type of the header.
         /// The given type must have a static TryParseList method.</typeparam>
         /// <param name="name">The name of the header to retrieve.</param>

src/Http/Http.Extensions/src/ResponseHeaders.cs

@@ -161,7 +161,7 @@ public IList<SetCookieHeaderValue> SetCookie
         /// <summary>
         /// Gets the value of header with <paramref name="name"/>.
         /// </summary>
-        /// <remarks><typeparamref name="T"/> must contain a TryParse method with the signature <code>public static bool TryParse(string, out T)</code>.</remarks>
+        /// <remarks><typeparamref name="T"/> must contain a TryParse method with the signature <c>public static bool TryParse(string, out T)</c>.</remarks>
         /// <typeparam name="T">The type of the header.
         /// The given type must have a static TryParse method.</typeparam>
         /// <param name="name">The name of the header to retrieve.</param>
@@ -174,7 +174,7 @@ public T Get<T>(string name)
         /// <summary>
         /// Gets the values of header with <paramref name="name"/>.
         /// </summary>
-        /// <remarks><typeparamref name="T"/> must contain a TryParseList method with the signature <code>public static bool TryParseList(IList&lt;string&gt;, out IList&lt;T&gt;)</code>.</remarks>
+        /// <remarks><typeparamref name="T"/> must contain a TryParseList method with the signature <c>public static bool TryParseList(IList&lt;string&gt;, out IList&lt;T&gt;)</c>.</remarks>
         /// <typeparam name="T">The type of the header.
         /// The given type must have a static TryParseList method.</typeparam>
         /// <param name="name">The name of the header to retrieve.</param>

src/Http/Routing/src/RouteConstraintBuilder.cs

@@ -90,8 +90,8 @@ public IDictionary<string, IRouteConstraint> Build()
         /// <remarks>
         /// If the <paramref name="value"/> is a string, it will be converted to a <see cref="RegexRouteConstraint"/>.
         ///
-        /// For example, the string <code>Product[0-9]+</code> will be converted to the regular expression
-        /// <code>^(Product[0-9]+)</code>. See <see cref="System.Text.RegularExpressions.Regex"/> for more details.
+        /// For example, the string <c>Product[0-9]+</c> will be converted to the regular expression
+        /// <c>^(Product[0-9]+)</c>. See <see cref="System.Text.RegularExpressions.Regex"/> for more details.
         /// </remarks>
         public void AddConstraint(string key, object value)
         {

src/Mvc/Mvc.Abstractions/src/ModelBinding/ModelStateDictionary.cs

@@ -81,7 +81,7 @@ public ModelStateDictionary(ModelStateDictionary dictionary)
         /// <see cref="ModelStateDictionary"/> tracks the number of model errors added by calls to
         /// <see cref="AddModelError(string, Exception, ModelMetadata)"/> or
         /// <see cref="TryAddModelError(string, Exception, ModelMetadata)"/>.
-        /// Once the value of <code>MaxAllowedErrors - 1</code> is reached, if another attempt is made to add an error,
+        /// Once the value of <c>MaxAllowedErrors - 1</c> is reached, if another attempt is made to add an error,
         /// the error message will be ignored and a <see cref="TooManyModelErrorsException"/> will be added.
         /// </para>
         /// <para>

src/Mvc/Mvc.Core/src/Controllers/ControllerFeatureProvider.cs

@@ -1,4 +1,4 @@
-// Copyright (c) .NET Foundation. All rights reserved.
+// Copyright (c) .NET Foundation. All rights reserved.
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 
 using System;
@@ -37,7 +37,7 @@ public void PopulateFeature(
         /// Determines if a given <paramref name="typeInfo"/> is a controller.
         /// </summary>
         /// <param name="typeInfo">The <see cref="TypeInfo"/> candidate.</param>
-        /// <returns><code>true</code> if the type is a controller; otherwise <code>false</code>.</returns>
+        /// <returns><see langword="true" /> if the type is a controller; otherwise <see langword="false" />.</returns>
         protected virtual bool IsController(TypeInfo typeInfo)
         {
             if (!typeInfo.IsClass)

src/Mvc/Mvc.Core/src/Formatters/MediaTypeCollection.cs

@@ -50,8 +50,8 @@ public void Insert(int index, MediaTypeHeaderValue item)
         /// Removes the first occurrence of a specific media type from the <see cref="MediaTypeCollection"/>.
         /// </summary>
         /// <param name="item"></param>
-        /// <returns><code>true</code> if <paramref name="item"/> is successfully removed; otherwise, <code>false</code>.
-        /// This method also returns <code>false</code> if <paramref name="item"/> was not found in the original 
+        /// <returns><see langword="true" /> if <paramref name="item"/> is successfully removed; otherwise, <see langword="false" />.
+        /// This method also returns <see langword="false" /> if <paramref name="item"/> was not found in the original 
         /// <see cref="MediaTypeCollection"/>.</returns>
         public bool Remove(MediaTypeHeaderValue item)
         {

src/Mvc/Mvc.Core/src/Routing/IRouteValueProvider.cs

@@ -25,7 +25,7 @@ namespace Microsoft.AspNetCore.Mvc.Routing
     /// <see cref="ControllerActionDescriptor.ActionName"/>
     /// </para>
     /// <example>
-    /// For an action like <code>MyApp.Controllers.HomeController.Index()</code>, in order to be selected, the
+    /// For an action like <c>MyApp.Controllers.HomeController.Index()</c>, in order to be selected, the
     /// <see cref="RouteData.Values"/> must contain the values
     /// { 
     ///     "action": "Index",
@@ -39,20 +39,20 @@ namespace Microsoft.AspNetCore.Mvc.Routing
     /// <see cref="IRouteValueProvider"/>) or are considered 'outside' of areas by having the value <c>null</c>.
     /// </para>
     /// <example>
-    /// Consider an application with two controllers, each with an <code>Index</code> action method:
-    ///     - <code>MyApp.Controllers.HomeController.Index()</code>
-    ///     - <code>MyApp.Areas.Blog.Controllers.HomeController.Index()</code>
-    /// where <code>MyApp.Areas.Blog.Controllers.HomeController</code> has an area attribute
-    /// <code>[Area("Blog")]</code>.
+    /// Consider an application with two controllers, each with an <c>Index</c> action method:
+    ///     - <c>MyApp.Controllers.HomeController.Index()</c>
+    ///     - <c>MyApp.Areas.Blog.Controllers.HomeController.Index()</c>
+    /// where <c>MyApp.Areas.Blog.Controllers.HomeController</c> has an area attribute
+    /// <c>[Area("Blog")]</c>.
     /// 
     /// For <see cref="RouteData.Values"/> like:
     /// { 
     ///     "action": "Index",
     ///     "controller": "Home"
     /// }
     /// 
-    /// <code>MyApp.Controllers.HomeController.Index()</code> will be selected.
-    /// <code>MyApp.Area.Blog.Controllers.HomeController.Index()</code> is not considered eligible because the
+    /// <c>MyApp.Controllers.HomeController.Index()</c> will be selected.
+    /// <c>MyApp.Area.Blog.Controllers.HomeController.Index()</c> is not considered eligible because the
     /// <see cref="RouteData.Values"/> does not contain the value 'Blog' for 'area'.
     /// 
     /// For <see cref="RouteData.Values"/> like:
@@ -62,9 +62,9 @@ namespace Microsoft.AspNetCore.Mvc.Routing
     ///     "controller": "Home"
     /// }
     /// 
-    /// <code>MyApp.Area.Blog.Controllers.HomeController.Index()</code> will be selected.
-    /// <code>MyApp.Controllers.HomeController.Index()</code> is not considered eligible because the route values
-    /// contain a value for 'area'. <code>MyApp.Controllers.HomeController.Index()</code> cannot match any value
+    /// <c>MyApp.Area.Blog.Controllers.HomeController.Index()</c> will be selected.
+    /// <c>MyApp.Controllers.HomeController.Index()</c> is not considered eligible because the route values
+    /// contain a value for 'area'. <c>MyApp.Controllers.HomeController.Index()</c> cannot match any value
     /// for 'area' other than <c>null</c>.
     /// </example>
     /// </remarks>

src/Mvc/Mvc.Razor/src/Internal/RazorInjectAttribute.cs

@@ -8,7 +8,7 @@ namespace Microsoft.AspNetCore.Mvc.Razor.Internal
     /// <summary>
     /// Specifies that the attributed property should be bound using request services.
     /// <para>
-    /// This attribute is used as the backing attribute for the <code>@inject</code>
+    /// This attribute is used as the backing attribute for the <c>@inject</c>
     /// Razor directive.
     /// </para>
     /// </summary>

src/Mvc/Mvc.Testing/src/WebApplicationFactoryContentRootAttribute.cs

@@ -1,4 +1,4 @@
-// Copyright (c) .NET Foundation. All rights reserved.
+// Copyright (c) .NET Foundation. All rights reserved.
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 
 using System;
@@ -16,7 +16,7 @@ namespace Microsoft.AspNetCore.Mvc.Testing
     /// <see cref="Key"/> is equal to <c>TEntryPoint</c> <see cref="Assembly.FullName"/>,
     /// order them by <see cref="Priority"/> in ascending order.
     /// <see cref="WebApplicationFactory{TEntryPoint}"/> will check for the existence of the marker
-    /// in <code>Path.Combine(<see cref="ContentRootPath"/>, Path.GetFileName(<see cref="ContentRootTest"/>))"</code>
+    /// in <c>Path.Combine(<see cref="ContentRootPath"/>, Path.GetFileName(<see cref="ContentRootTest"/>))"</c>
     /// and if the file exists it will set the content root to <see cref="ContentRootPath"/>.
     /// </summary>
     [AttributeUsage(AttributeTargets.Assembly, Inherited = false, AllowMultiple = true)]
@@ -33,7 +33,7 @@ public sealed class WebApplicationFactoryContentRootAttribute : Attribute
         /// </param>
         /// <param name="contentRootPath">The path to the content root. This path can be either relative or absolute.
         /// In case the path is relative, the path will be combined with
-        /// <code><see cref="Directory.GetCurrentDirectory()"/></code></param>
+        /// <see cref="Directory.GetCurrentDirectory()"/></param>
         /// <param name="contentRootTest">
         /// A file that will be use as a marker to determine that the content root path for the given context is correct.
         /// </param>