fix paramrefs for System.Net

dotnet · Feb 4, 2025 · 11bad29 · 11bad29
1 parent b79650a
commit 11bad29
Show file tree

Hide file tree

Showing 25 changed files with 2,252 additions and 2,294 deletions.
diff --git a/xml/System.Net.Http.Headers/HttpHeaders.xml b/xml/System.Net.Http.Headers/HttpHeaders.xml
@@ -144,17 +144,17 @@
         <param name="values">A list of header values to add to the collection.</param>
         <summary>Adds the specified header and its values into the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Header names are enforced to be valid HTTP tokens, where a token is defined as any set of ASCII letters, digits, or symbols from the ``"!#$%&'*+-.^_`|~"`` set, matching [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-collected-abnf)'s definition. Non-ASCII characters are not allowed in a header name.  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Header names are enforced to be valid HTTP tokens, where a token is defined as any set of ASCII letters, digits, or symbols from the ``"!#$%&'*+-.^_`|~"`` set, matching [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-collected-abnf)'s definition. Non-ASCII characters are not allowed in a header name.
+
+ The header `values` will be parsed and validated.
+
+ If the specified header does not exist, the <xref:System.Net.Http.Headers.HttpHeaders.Add%2A> method inserts a new header into the list of header name/value pairs.
+
+ If the specified header is already present, `values` are added to the comma-separated list of values associated with the header.
 
- The header `values` will be parsed and validated.  
-  
- If the specified header does not exist, the <xref:System.Net.Http.Headers.HttpHeaders.Add%2A> method inserts a new header into the list of header name/value pairs.  
-  
- If the specified header is already present, `values` are added to the comma-separated list of values associated with the header.  
-  
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">The name cannot be null or empty.</exception>
@@ -215,17 +215,17 @@ The header value format is invalid for this header name, or the header does not
         <param name="value">The content of the header.</param>
         <summary>Adds the specified header and its value into the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Header names are enforced to be valid HTTP tokens, where a token is defined as any set of ASCII letters, digits, or symbols from the ``"!#$%&'*+-.^_`|~"`` set, matching [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-collected-abnf)'s definition. Non-ASCII characters are not allowed in a header name.  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Header names are enforced to be valid HTTP tokens, where a token is defined as any set of ASCII letters, digits, or symbols from the ``"!#$%&'*+-.^_`|~"`` set, matching [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-collected-abnf)'s definition. Non-ASCII characters are not allowed in a header name.
+
+ The header `values` will be parsed and validated.
+
+ If the specified header does not exist, the <xref:System.Net.Http.Headers.HttpHeaders.Add%2A> method inserts a new header into the list of header name/value pairs.
+
+ If the specified header is already present, `value` is added to the comma-separated list of values associated with the header.
 
- The header `values` will be parsed and validated.  
-  
- If the specified header does not exist, the <xref:System.Net.Http.Headers.HttpHeaders.Add%2A> method inserts a new header into the list of header name/value pairs.  
-  
- If the specified header is already present, `value` is added to the comma-separated list of values associated with the header.  
-  
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">The name cannot be null or empty.</exception>
@@ -471,7 +471,7 @@ The header value format is invalid for this header name, or the header does not
         <param name="name">The name of the header to remove from the collection.</param>
         <summary>Removes the specified header from the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</summary>
         <returns>
-          <see langword="true" /> if <paramref name="name" /> is successfully removed; otherwise, <see langword="false" />.  This method also returns <see langword="false" /> if <paramref name="item" /> was not found in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection or if <paramref name="item" /> is <see langword="null" />.
+          <see langword="true" /> if <paramref name="name" /> is successfully removed; otherwise, <see langword="false" />.  This method also returns <see langword="false" /> if <paramref name="name" /> was not found in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection or if <paramref name="name" /> is <see langword="null" />.
         </returns>
         <remarks>To be added.</remarks>
       </Docs>