Skip to content

Commit 64c8615

Browse files
author
Ron Petrusha
authored
Fix broken xrefs (#2576)
* Fix broken xrefs * Reverted changes identified by bug
1 parent 1bda73d commit 64c8615

File tree

4 files changed

+11
-9
lines changed

4 files changed

+11
-9
lines changed

xml/System.IO/WindowsRuntimeStreamExtensions.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ Here's the XAML code that is associated with the previous example.
8989
## Remarks
9090
9191
> [!NOTE]
92-
> In Visual Basic and C#, you can call this method as an instance method on any object of type <System.IO.Stream>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md).
92+
> In Visual Basic and C#, you can call this method as an instance method on any object of type <xref:System.IO.Stream>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md).
9393
9494
## Examples
9595
@@ -435,7 +435,7 @@ In most situations, buffering improves the performance of stream operations. You
435435
> [!NOTE]
436436
> In Visual Basic and C#, you can call this method as an instance method on any object of type <xref:System.IO.Stream>. When you use instance method syntax to call this method, omit the first parameter. For more information, see [Extension Methods (Visual Basic)](~/docs/visual-basic/programming-guide/language-features/procedures/extension-methods.md) or [Extension Methods (C# Programming Guide)](~/docs/csharp/programming-guide/classes-and-structs/extension-methods.md).
437437
438-
A default buffer size of 16,384 bytes is used when converting the stream. To specify a different buffer size, use the <xref:> overload.
438+
A default buffer size of 16,384 bytes is used when converting the stream. To specify a different buffer size, use the <xref:System.IO.WindowsRuntimeStreamExtensions.AsStreamForWrite(Windows.Storage.Streams.IOutputStream,System.Int32)> overload.
439439
440440
## Examples
441441
The following example shows how to use the <xref:System.IO.WindowsRuntimeStreamExtensions.AsStreamForWrite%2A> and <xref:System.IO.WindowsRuntimeStreamExtensions.AsStreamForRead%2A> methods to convert a managed stream to and from a stream in the Windows Runtime.

xml/System.Text.Json/Utf8JsonWriter.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ To be able to format the output with indentation and white space OR to skip vali
5858
<Docs>
5959
<param name="bufferWriter">The destination for writing JSON text.</param>
6060
<param name="options">Defines the customized behavior of the <see cref="T:System.Text.Json.Utf8JsonWriter" /> By default, it writes minimized JSON (with no extra whitespace) and validates that the JSON being written is structurally valid according to the JSON RFC.</param>
61-
<summary>Constructs a new <see cref="T:System.Text.Json.Utf8JsonWriter" /> instance with a specified <see cref="T:System.Buffers.IBufferWriter&lt;System.Byte&gt;" />.</summary>
61+
<summary>Constructs a new <see cref="T:System.Text.Json.Utf8JsonWriter" /> instance with a specified <see langword="System.Buffers.IBufferWriter&lt;System.Byte&gt;" />.</summary>
6262
<remarks>To be added.</remarks>
6363
<exception cref="T:System.ArgumentNullException"><paramref name="bufferWriter" /> is <see langword="null" />.</exception>
6464
</Docs>

xml/System/DateTime.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4812,7 +4812,7 @@ juillet 2009
48124812
<summary>Converts the string representation of a date and time to its <see cref="T:System.DateTime" /> equivalent.</summary>
48134813
<remarks>
48144814
<format type="text/markdown"><![CDATA[
4815-
4815+
48164816
## Remarks
48174817
In this section:
48184818

xml/System/Math.xml

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4491,7 +4491,7 @@ Remainder = (Math.Abs(dividend) - (Math.Abs(divisor) *
44914491
<remarks>
44924492
<format type="text/markdown"><![CDATA[
44934493
4494-
<a name="remarks_round"></a>
4494+
<a name="remarks-round"></a>
44954495
## Remarks
44964496
44974497
In this section:
@@ -4500,7 +4500,7 @@ In this section:
45004500
- [Midpoint values and rounding conventions](#midpoint-values-and-rounding-conventions)
45014501
- [Rounding and precision](#rounding-and-precision)
45024502
- [Rounding and single-precision floating point values](#rounding-and-single-precision-floating-point-values)
4503-
- [Examples of individual overloads](#examples)
4503+
- [Examples of individual overloads](#round-examples)
45044504
45054505
### Which method do I call?
45064506
@@ -4513,7 +4513,7 @@ You can use the following table to select an appropriate rounding method. In add
45134513
|Round a number to a specified number of fractional digits by using the rounding to nearest convention.|<xref:System.Math.Round%28System.Decimal%2CSystem.Int32%29><br /><br /> -or-<br /><br /> <xref:System.Math.Round%28System.Double%2CSystem.Int32%29>|
45144514
|Round a number to a specified number of fractional digits by using a specified rounding convention.|<xref:System.Math.Round%28System.Decimal%2CSystem.Int32%2CSystem.MidpointRounding%29><br /><br /> -or-<br /><br /> <xref:System.Math.Round%28System.Double%2CSystem.Int32%2CSystem.MidpointRounding%29>|
45154515
|Round a <xref:System.Single> value to a specified number of fractional digits by using a specified rounding convention and minimizing the loss of precision.|Convert the <xref:System.Single> to a <xref:System.Decimal> and call <xref:System.Math.Round%28System.Decimal%2CSystem.Int32%2CSystem.MidpointRounding%29>.|
4516-
|Round a number to a specified number of fractional digits while minimizing problems of precision in rounding midpoint values.|Call a rounding method that implements a "greater than or approximately equal to" comparison. See [Rounding and precision](#Precision).|
4516+
|Round a number to a specified number of fractional digits while minimizing problems of precision in rounding midpoint values.|Call a rounding method that implements a "greater than or approximately equal to" comparison. See [Rounding and precision](#precision).|
45174517
|Round a fractional value to an integer that is greater than the fractional value. For example, round 3.1 to 4.|<xref:System.Math.Ceiling%2A>|
45184518
|Round a fractional value to an integer that is less than the fractional value. For example, round 3.9 to 3.|<xref:System.Math.Floor%2A>|
45194519
@@ -4555,6 +4555,7 @@ By default, the <xref:System.Math.Round%2A> method uses the rounding to nearest
45554555
|<xref:System.Math.Round%28System.Decimal%2CSystem.Int32%2CSystem.MidpointRounding%29>|Determined by `mode` parameter|
45564556
|<xref:System.Math.Round%28System.Double%2CSystem.Int32%2CSystem.MidpointRounding%29>|Determined by `mode` parameter|
45574557
4558+
<a name="precision"></a>
45584559
### Rounding and precision
45594560
45604561
In order to determine whether a rounding operation involves a midpoint value, the <xref:System.Math.Round%2A> method multiplies the original value to be rounded by 10<sup>n</sup>, where *n* is the desired number of fractional digits in the return value, and then determines whether the remaining fractional portion of the value is greater than or equal to .5. This is a slight variation on a test for equality, and as discussed in the "Testing for Equality" section of the <xref:System.Double> reference topic, tests for equality with floating-point values are problematic because of the floating-point format's issues with binary representation and precision. This means that any fractional portion of a number that is slightly less than .5 (because of a loss of precision) will not be rounded upward.
@@ -4572,7 +4573,7 @@ Problems of precision in rounding midpoint values are most likely to arise in th
45724573
45734574
- When the value to be rounded is calculated from one or more floating-point operations.
45744575
4575-
- When the value to be rounded is a <xref:System.Single> rather than a <xref:System.Double> or <xref:System.Decimal>. For more information, see the next section, [Rounding and single-precision floating-point values](#Single).
4576+
- When the value to be rounded is a <xref:System.Single> rather than a <xref:System.Double> or <xref:System.Decimal>. For more information, see the next section, [Rounding and single-precision floating-point values](#rounding-and-single-precision-floating-point-values).
45764577
45774578
In cases where the lack of precision in rounding operations is problematic, you can do the following:
45784579
@@ -4593,7 +4594,8 @@ The <xref:System.Math.Round%2A> method includes overloads that accept arguments
45934594
This unexpected result is due to a loss of precision in the conversion of the <xref:System.Single> value to a <xref:System.Double>. Because the resulting <xref:System.Double> value of 16.325000762939453 is not a midpoint value and is greater than 16.325, it is always rounded upward.
45944595
45954596
In many cases, as the example illustrates, the loss of precision can be minimized or eliminated by casting or converting the <xref:System.Single> value to a <xref:System.Decimal>. Note that, because this is a narrowing conversion, it requires using a cast operator or calling a conversion method.
4596-
4597+
4598+
<a name="round-examples"></a>
45974599
## Examples
45984600
45994601
In addition to the examples in the [Remarks](#remarks-round) section, this article includes examples that illustrate the following overloads of the `Math.Round` method:

0 commit comments

Comments
 (0)