From 5d8db6f6202f2864e72b4cb2a0fa5bfe9a9e5c96 Mon Sep 17 00:00:00 2001
From: carlossanlop <calope@microsoft.com>
Date: Mon, 16 Sep 2019 11:45:01 -0700
Subject: [PATCH 1/2] Automatically port
 Reflection.PortableExecutable.CoffHeader

---
 .../CoffHeader.xml                                 | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/xml/System.Reflection.PortableExecutable/CoffHeader.xml b/xml/System.Reflection.PortableExecutable/CoffHeader.xml
index a32b4b24aa3..52693b9673c 100644
--- a/xml/System.Reflection.PortableExecutable/CoffHeader.xml
+++ b/xml/System.Reflection.PortableExecutable/CoffHeader.xml
@@ -44,7 +44,7 @@
         <ReturnType>System.Reflection.PortableExecutable.Characteristics</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The flags that indicate the attributes of the file.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -70,7 +70,7 @@
         <ReturnType>System.Reflection.PortableExecutable.Machine</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The type of target machine.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -96,7 +96,7 @@
         <ReturnType>System.Int16</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The number of sections. This indicates the size of the section table, which immediately follows the headers.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -122,7 +122,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The number of entries in the symbol table. This data can be used to locate the string table, which immediately follows the symbol table. This value should be zero for a PE image.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -148,7 +148,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The file pointer to the COFF symbol table, or zero if no COFF symbol table is present. This value should be zero for a PE image.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -174,7 +174,7 @@
         <ReturnType>System.Int16</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The size of the optional header, which is required for executable files but not for object files. This value should be zero for an object file.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -200,7 +200,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The low 32 bits of the number of seconds since 00:00 January 1, 1970, that indicates when the file was created.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

From 34ce33428978783c2cb6a1dbaaecf33e5645a20e Mon Sep 17 00:00:00 2001
From: Ron Petrusha <ronpet@microsoft.com>
Date: Thu, 26 Sep 2019 14:50:14 -0700
Subject: [PATCH 2/2] Made direct edits.

---
 .../CoffHeader.xml                            | 30 +++++++++----------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/xml/System.Reflection.PortableExecutable/CoffHeader.xml b/xml/System.Reflection.PortableExecutable/CoffHeader.xml
index 52693b9673c..feca081e06f 100644
--- a/xml/System.Reflection.PortableExecutable/CoffHeader.xml
+++ b/xml/System.Reflection.PortableExecutable/CoffHeader.xml
@@ -19,7 +19,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents the header of a COFF file.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -44,8 +44,8 @@
         <ReturnType>System.Reflection.PortableExecutable.Characteristics</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The flags that indicate the attributes of the file.</summary>
-        <value>To be added.</value>
+        <summary>Gets the flags that indicate the attributes of the file.</summary>
+        <value>The flags that indicate the attributes of the file.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -70,8 +70,8 @@
         <ReturnType>System.Reflection.PortableExecutable.Machine</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The type of target machine.</summary>
-        <value>To be added.</value>
+        <summary>Gets the type of the target machine.</summary>
+        <value>The type of the target machine.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -96,8 +96,8 @@
         <ReturnType>System.Int16</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The number of sections. This indicates the size of the section table, which immediately follows the headers.</summary>
-        <value>To be added.</value>
+        <summary>Gets the number of sections. This indicates the size of the section table, which immediately follows the headers.</summary>
+        <value>The number of sections.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -122,9 +122,9 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The number of entries in the symbol table. This data can be used to locate the string table, which immediately follows the symbol table. This value should be zero for a PE image.</summary>
+        <summary>Gets the number of entries in the symbol table. This data can be used to locate the string table, which immediately follows the symbol table. This value should be zero for a PE image.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>The number of entries in the symbol table.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PointerToSymbolTable">
@@ -148,8 +148,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The file pointer to the COFF symbol table, or zero if no COFF symbol table is present. This value should be zero for a PE image.</summary>
-        <value>To be added.</value>
+        <summary>Gets the file pointer to the COFF symbol table.</summary>
+        <value>The file pointer to the COFF symbol table, or zero if no COFF symbol table is present. This value should be zero for a PE image.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -174,8 +174,8 @@
         <ReturnType>System.Int16</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The size of the optional header, which is required for executable files but not for object files. This value should be zero for an object file.</summary>
-        <value>To be added.</value>
+        <summary>Gets the size of the optional header, which is required for executable files but not for object files. This value should be zero for an object file.</summary>
+        <value>The size of the optional header.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -200,8 +200,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The low 32 bits of the number of seconds since 00:00 January 1, 1970, that indicates when the file was created.</summary>
-        <value>To be added.</value>
+        <summary>Gets a value that indicates when the file was created.</summary>
+        <value>The low 32 bits of the number of seconds since 00:00 January 1, 1970, which indicates when the file was created.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>