From 5fbeba13042200773ca51470b3c02ea31c563870 Mon Sep 17 00:00:00 2001
From: Anipik <anirudhagnihotry098@gmail.com>
Date: Wed, 24 Jul 2019 11:45:37 -0700
Subject: [PATCH 1/3] adding docs

---
 .../Unsafe.xml                                | 47 ++++++++++---------
 1 file changed, 25 insertions(+), 22 deletions(-)

diff --git a/xml/System.Runtime.CompilerServices/Unsafe.xml b/xml/System.Runtime.CompilerServices/Unsafe.xml
index 2b56c825de5..3c18903bf61 100644
--- a/xml/System.Runtime.CompilerServices/Unsafe.xml
+++ b/xml/System.Runtime.CompilerServices/Unsafe.xml
@@ -49,11 +49,13 @@
         <Parameter Name="elementOffset" Type="System.Int32" Index="1" FrameworkAlternate="dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;netcore-3.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="source">To be added.</param>
-        <param name="elementOffset">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of void pointer.</typeparam>
+        <param name="source">The void pointer to add the offset to.</param>
+        <param name="elementOffset">The offset to add.</param>
+        <summary>
+          Adds an element offset to the given void pointer.
+        </summary>
+        <returns>A new void pointer that reflects the addition of offset to pointer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -764,11 +766,11 @@
         <Parameter Name="right" Type="T" RefType="ref" Index="1" FrameworkAlternate="dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;netcore-3.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="left">To be added.</param>
-        <param name="right">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of the reference.</typeparam>
+        <param name="left">The first value to comppare.</param>
+        <param name="right">The second value to compare.</param>
+        <summary>Returns a value that indicates whether a specified reference is greater than another specified reference.</summary>
+        <returns><see langword="true" /> if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -797,11 +799,11 @@
         <Parameter Name="right" Type="T" RefType="ref" Index="1" FrameworkAlternate="dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;netcore-3.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="left">To be added.</param>
-        <param name="right">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of the reference.</typeparam>
+        <param name="left">The first value to comppare.</param>
+        <param name="right">The second value to compare.</param>
+        <summary>Returns a value that indicates whether a specified reference is less than another specified reference.</summary>
+        <returns><see langword="true" /> if <paramref name="left" /> is less than <paramref name="right" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -964,11 +966,13 @@
         <Parameter Name="elementOffset" Type="System.Int32" Index="1" FrameworkAlternate="dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;netcore-3.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="source">To be added.</param>
-        <param name="elementOffset">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of void pointer.</typeparam>
+        <param name="source">The void pointer to subtract the offset from.</param>
+        <param name="elementOffset">The offset to subtract.</param>
+        <summary>
+          Subtracts an element offset from the given void pointer.
+        </summary>
+        <returns>A new void pointer that reflects the subtraction of offset from pointer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1062,8 +1066,7 @@
       <Docs>
         <typeparam name="T">The type of reference.</typeparam>
         <param name="source">The reference to subtract the offset from.</param>
-        <param name="bytesOffset">The offset to subtract.</param>
-        <param name="byteOffset">To be added.</param>
+        <param name="byteOffset">The offset to subtract.</param>
         <summary>
         Subtracts a byte offset from the given reference.
         </summary>

From 7cdd2442a65802f6263d993c118276a6be4241fe Mon Sep 17 00:00:00 2001
From: Anipik <anirudhagnihotry098@gmail.com>
Date: Wed, 24 Jul 2019 13:34:00 -0700
Subject: [PATCH 2/3] summary on one line and comppare -> compare

---
 xml/System.Runtime.CompilerServices/Unsafe.xml | 16 +++++-----------
 1 file changed, 5 insertions(+), 11 deletions(-)

diff --git a/xml/System.Runtime.CompilerServices/Unsafe.xml b/xml/System.Runtime.CompilerServices/Unsafe.xml
index 3c18903bf61..3875124b165 100644
--- a/xml/System.Runtime.CompilerServices/Unsafe.xml
+++ b/xml/System.Runtime.CompilerServices/Unsafe.xml
@@ -52,9 +52,7 @@
         <typeparam name="T">The type of void pointer.</typeparam>
         <param name="source">The void pointer to add the offset to.</param>
         <param name="elementOffset">The offset to add.</param>
-        <summary>
-          Adds an element offset to the given void pointer.
-        </summary>
+        <summary>Adds an element offset to the given void pointer.</summary>
         <returns>A new void pointer that reflects the addition of offset to pointer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -187,9 +185,7 @@
         <typeparam name="T">The type of reference.</typeparam>
         <param name="left">The first reference to compare.</param>
         <param name="right">The second reference to compare.</param>
-        <summary>
-          Determines whether the specified references point to the same location.
-        </summary>
+        <summary>Determines whether the specified references point to the same location.</summary>
         <returns>
           <see langword="true" /> if <paramref name="left" /> and <paramref name="right" /> point to the same location; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
@@ -767,7 +763,7 @@
       </Parameters>
       <Docs>
         <typeparam name="T">The type of the reference.</typeparam>
-        <param name="left">The first value to comppare.</param>
+        <param name="left">The first value to compare.</param>
         <param name="right">The second value to compare.</param>
         <summary>Returns a value that indicates whether a specified reference is greater than another specified reference.</summary>
         <returns><see langword="true" /> if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, <see langword="false" />.</returns>
@@ -800,7 +796,7 @@
       </Parameters>
       <Docs>
         <typeparam name="T">The type of the reference.</typeparam>
-        <param name="left">The first value to comppare.</param>
+        <param name="left">The first value to compare.</param>
         <param name="right">The second value to compare.</param>
         <summary>Returns a value that indicates whether a specified reference is less than another specified reference.</summary>
         <returns><see langword="true" /> if <paramref name="left" /> is less than <paramref name="right" />; otherwise, <see langword="false" />.</returns>
@@ -969,9 +965,7 @@
         <typeparam name="T">The type of void pointer.</typeparam>
         <param name="source">The void pointer to subtract the offset from.</param>
         <param name="elementOffset">The offset to subtract.</param>
-        <summary>
-          Subtracts an element offset from the given void pointer.
-        </summary>
+        <summary>Subtracts an element offset from the given void pointer.</summary>
         <returns>A new void pointer that reflects the subtraction of offset from pointer.</returns>
         <remarks>To be added.</remarks>
       </Docs>

From dbd6aeeeee9a0f3ec880455e1ba49746d73b7a34 Mon Sep 17 00:00:00 2001
From: Anirudh Agnihotry <anirudhagnihotry098@gmail.com>
Date: Wed, 24 Jul 2019 13:36:36 -0700
Subject: [PATCH 3/3] adding specified prefix

Co-Authored-By: Maira Wenzel <mairaw@microsoft.com>
---
 xml/System.Runtime.CompilerServices/Unsafe.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/xml/System.Runtime.CompilerServices/Unsafe.xml b/xml/System.Runtime.CompilerServices/Unsafe.xml
index 3875124b165..c43530b086b 100644
--- a/xml/System.Runtime.CompilerServices/Unsafe.xml
+++ b/xml/System.Runtime.CompilerServices/Unsafe.xml
@@ -53,7 +53,7 @@
         <param name="source">The void pointer to add the offset to.</param>
         <param name="elementOffset">The offset to add.</param>
         <summary>Adds an element offset to the given void pointer.</summary>
-        <returns>A new void pointer that reflects the addition of offset to pointer.</returns>
+        <returns>A new void pointer that reflects the addition of offset to the specified pointer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -962,11 +962,11 @@
         <Parameter Name="elementOffset" Type="System.Int32" Index="1" FrameworkAlternate="dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;netcore-3.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">The type of void pointer.</typeparam>
+        <typeparam name="T">The type of the void pointer.</typeparam>
         <param name="source">The void pointer to subtract the offset from.</param>
         <param name="elementOffset">The offset to subtract.</param>
         <summary>Subtracts an element offset from the given void pointer.</summary>
-        <returns>A new void pointer that reflects the subtraction of offset from pointer.</returns>
+        <returns>A new void pointer that reflects the subtraction of offset from the specified pointer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>