adding summary info to bring into compliance (#4370)

craigcaseyMSFT · gewarren · web-flow · commit 8ce12db6e3d4 · 2020-06-16T12:46:44.000-07:00
* adding summary info to bring into compliance
* Fix crefs
Co-authored-by: Genevieve Warren &lt;24882762+gewarren@users.noreply.github.com&gt;
diff --git a/xml/IStream.xml b/xml/IStream.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides the managed definition of the IStream interface.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedBinder.xml b/xml/ISymUnmanagedBinder.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a symbol binder for unmanaged code.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedDocument.xml b/xml/ISymUnmanagedDocument.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a document referenced by a symbol store.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedDocumentWriter.xml b/xml/ISymUnmanagedDocumentWriter.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides methods for writing to a document referenced by a symbol store.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedMethod.xml b/xml/ISymUnmanagedMethod.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a method within the symbol store.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedReader.xml b/xml/ISymUnmanagedReader.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a symbol reader that provides access to documents, methods, and variables within a symbol store.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedScope.xml b/xml/ISymUnmanagedScope.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a lexical scope within a method.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedVariable.xml b/xml/ISymUnmanagedVariable.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a variable, such as a parameter, a local variable, or a field.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/ISymUnmanagedWriter.xml b/xml/ISymUnmanagedWriter.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a symbol writer, and provides methods to define documents, sequence points, lexical scopes, and variables.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
diff --git a/xml/System.Data.Odbc/OdbcCommand.xml b/xml/System.Data.Odbc/OdbcCommand.xml
@@ -638,7 +638,7 @@ SELECT * FROM Customers WHERE CustomerID = ?
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>When overridden in a derived class, creates a new instance of a <see cref="T:System.Data.Common.DbParameter" /> object.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Security.Cryptography/MD5CryptoServiceProvider.xml b/xml/System.Security.Cryptography/MD5CryptoServiceProvider.xml
@@ -183,7 +183,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Releases the resources that are being used by the <see cref="T:System.Security.Cryptography.MD5CryptoServiceProvider" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.ServiceModel/InstanceContext.xml b/xml/System.ServiceModel/InstanceContext.xml
@@ -234,7 +234,7 @@
         <ReturnType>System.TimeSpan</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>When overridden in a derived class, gets the default interval of time provided for a close operation to complete.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -272,7 +272,7 @@
         <ReturnType>System.TimeSpan</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>When overridden in a derived class, gets the default interval of time provided for an open operation to complete.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -605,7 +605,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Inserts processing on a communication object after it transitions to the closing state due to the invocation of a synchronous abort operation.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -647,7 +647,7 @@
         <param name="timeout">To be added.</param>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Inserts processing after a communication object transitions to the closing state due to the invocation of an asynchronous close operation.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -690,7 +690,7 @@
         <param name="timeout">To be added.</param>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Inserts processing on a communication object after it transitions to the opening state due to the invocation of an asynchronous open operation.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -729,7 +729,7 @@
       </Parameters>
       <Docs>
         <param name="timeout">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Inserts processing on a communication object after it transitions to the closing state due to the invocation of a synchronous close operation.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -764,7 +764,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Invoked during the transition of a communication object into the closing state.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -802,7 +802,7 @@
       </Parameters>
       <Docs>
         <param name="result">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Completes an asynchronous operation on the close of a communication object.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -840,7 +840,7 @@
       </Parameters>
       <Docs>
         <param name="result">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Completes an asynchronous operation on the open of a communication object.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -875,7 +875,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Inserts processing on a communication object after it transitions to the faulted state due to the invocation of a synchronous fault operation.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -913,7 +913,7 @@
       </Parameters>
       <Docs>
         <param name="timeout">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Inserts processing on a communication object after it transitions into the opening state, which must complete within a specified interval of time.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -948,7 +948,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Invoked during the transition of a communication object into the opened state.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -983,7 +983,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Invoked during the transition of a communication object into the opening state.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Text/UnicodeEncoding.xml b/xml/System.Text/UnicodeEncoding.xml
@@ -728,7 +728,7 @@
       </Parameters>
       <Docs>
         <param name="s">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Encodes a set of characters from the specified string into the specified byte array.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Transactions.Configuration/DefaultSettingsSection.xml b/xml/System.Transactions.Configuration/DefaultSettingsSection.xml
@@ -121,7 +121,7 @@
         <ReturnType>System.Configuration.ConfigurationPropertyCollection</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the collection of properties.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Transactions.Configuration/MachineSettingsSection.xml b/xml/System.Transactions.Configuration/MachineSettingsSection.xml
@@ -122,7 +122,7 @@
         <ReturnType>System.Configuration.ConfigurationPropertyCollection</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the collection of properties.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Web.Handlers/TraceHandler.xml b/xml/System.Web.Handlers/TraceHandler.xml
@@ -167,7 +167,7 @@
       </Parameters>
       <Docs>
         <param name="datasets">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Writes the details of recent HTTP request traffic to the response stream.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Web.Services.Description/MessageBinding.xml b/xml/System.Web.Services.Description/MessageBinding.xml
@@ -90,7 +90,7 @@
         <ReturnType>System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" /> associated with the <see cref="T:System.Web.Services.Description.DocumentableItem" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Web.Services.Description/Service.xml b/xml/System.Web.Services.Description/Service.xml
@@ -128,7 +128,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the name of the item.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Xml.Serialization/XmlDeserializationEvents.xml b/xml/System.Xml.Serialization/XmlDeserializationEvents.xml
@@ -58,7 +58,7 @@
         <ReturnType>System.Xml.Serialization.XmlAttributeEventHandler</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets an object that represents the method that handles the <see cref="E:System.Xml.Serialization.XmlSerializer.UnknownAttribute" /> event.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -127,7 +127,7 @@
         <ReturnType>System.Xml.Serialization.XmlElementEventHandler</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets an object that represents the method that handles the <see cref="E:System.Xml.Serialization.XmlSerializer.UnknownElement" /> event.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -196,7 +196,7 @@
         <ReturnType>System.Xml.Serialization.XmlNodeEventHandler</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets an object that represents the method that handles the <see cref="E:System.Xml.Serialization.XmlSerializer.UnknownNode" /> event.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -265,7 +265,7 @@
         <ReturnType>System.Xml.Serialization.UnreferencedObjectEventHandler</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets an object that represents the method that handles the <see cref="E:System.Xml.Serialization.XmlSerializer.UnreferencedObject" /> event.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Xml/XmlNodeReader.xml b/xml/System.Xml/XmlNodeReader.xml
@@ -992,7 +992,7 @@ This property does not move the reader.
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>When overridden in a derived class, gets the value of the attribute with the specified name.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/_GUID.xml b/xml/_GUID.xml
@@ -25,7 +25,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a globally unique identifier (GUID).</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members />
